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are  entered  and  converted  into  digital  form  is  by  tracing 
relevant  map  features  with  an  electronic  instrument  called 
a  digitizer.  In  GRASS  version  4.0,  the  program  used  to 
conduct  this  conversion  is  called  v.digit. 

This  manual  discusses  v.digit  options.  The  v.digit 
program  is  an  interactive,  menu-driven  vector  digitizing, 
labeling,  and  editing  package.  The  samples  in  this 
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GRASS  4.0  MAP  DIGITIZING  MANUAL:  v.digit 


1.  INTRODUCTION 


1.1.  Background 

The  Geographic  Resources  Analysis  Support  System  (GRASS)  is  a  public  domain,  image  processing 
and  geographic  information  system  (GIS)  originally  developed  by  researchers  in  the  Environmental 
Division  of  the  U.S.  Army  Corps  of  Engineers  Construction  Engineering  Research  Laboratory 
(USACERL-EN)  in  Champaign,  IL.  The  system  is  used  to  input,  manipulate,  analyze,  and  output  geo¬ 
graphic  data  by  users  in  both  military  and  nonmilitary  and  public  and  private  agencies  based  in  North 
America,  Europe,  and  other  parts  of  the  world.  v.digit  is  a  robust  map  development  software  package 
used  for  vector  digitizing,  editing,  and  labeling,  and  the  conversion  of  vector  data  to  raster  format.  This 
document  details  the  capabilities  of  v.digit,  a  highly,  interactive,  menu  driven,  map  digitizing  package 
included  among  GRASS  software. 

Although  most  GRASS  development  has  been  conducted  at  USACERL,  system  integration,  develop¬ 
ment,  testing,  distribution,  training,  and  support  is  performed  by  numerous  publicly  and  privately- 
operated  sites  throughout  the  world.  GRASS  version  4.0  implemented  significant  additions  and 
modifications  to  system  libraries  and  programming  code.  This  document  reflects  modifications  made  to 
GRASS  version  4.0  map  development  programs. 


1.2.  Objective 

Ihe  objective  of  this  work  is  to  guide  the  user  through  the  process  of  using  v.digit  to  develop  a  GRASS 
database. 


13.  Approach 

Current  GRASS  v  .digit  map  development  and  data  import /ex  port  functions  are  examined  in  this  report. 


1 .4.  Scope 

This  document  discusses  the  4.0  release  version  of  the  GRASS  v.digit  program,  completed  in  the  Sum¬ 
mer  of  1991.  Some  elements  of  this  document  will  Ire  out  of  date  and  inaccurate  for  post-4 .0  software 
releases.  Additionally,  although  it  is  planned  that  future  releases  of  GRASS  issued  by  USACERL  and 
the  USDA  SGS  will  Ire  identical,  they  may  offer  somewhat  different  functions  in  GRASS  4.0.  Ihe 
functions  descrilxxl  in  this  tutorial  are  those  of  the  USACERL  GRASS  4.0  release,  available  to  till 
(JR  ASS  users. 
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1.5.  Mode  of  Technology  Transfer 

GRASS  is  being  transferred  to  the  field  through  the  following  mechanisms:  training  programs,  a  user 
support  center,  newsletters,  extensive  documentation,  institutional  structures  at  the  Army  and 
interagency  levels,  communication  networks,  and  other  forums. 

User  feedback  on  GRASS  program  capabilities,  documentation,  and  other  technology  transfer  mechan¬ 
isms  is  important  to  the  development  of  the  system.  Users  are  encouraged  to  communicate  such  feed¬ 
back  to  the  GRASS  development  staff  at  USACERL,  via  existing  electronic  communication  networks 
and  via  the  GRASS  Information  Center  at  USACERL,  P.O.  Box  9005,  Champaign,  IL  61826-9005; 
phone  217-373-7220;  fax  217-373-7222;  or  e-mail  grassbug@zorro.cecer.amty mil. 
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2.  USING  GRASS  FOR  MAP  DEVELOPMENT 

A  great  amount  of  information  is  stored  on  paper  maps.  Such  data  are  useful  when  building  a  geo¬ 
graphic  information  system  (GIS)  database;  however,  managing  the  large  quantities  of  data  needed  can 
be  cumbersome.  Map  information  can  be  mere  easily  manipulated  in  digital  form  by  a  computer. 
Within  the  GRASS  Geographic  Information  System,  map  development  entails  the  production  of  vector, 
raster,  and  support  files  that  are  used  within  GRASS  to  represent  map  features.  One  way  that  analog 
map  data  is  entered  and  converted  into  digital  form  is  by  manually  tracing  relevant  map  features  with 
an  electronic  instrument  called  a  digitizer.  In  GRASS  version  4.0,  the  program  used  to  conduct  this 
conversion  is  called  v.digit. 

The  v.digit  program  is  an  interactive,  menu  driven,  vector  digitizing,  labeling,  and  editing  package. 
This  manual  discusses  the  v .digit  options  and  guides  the  user  through  a  sample  digitizing  session.  To 
follow  the  examples  in  this  manual,  the  user  will  need  a  workstation  minimally  consisting  of  a  graphics 
monitor  and  keyboard,  a  pointing  device  (mouse),  and  a  digitizing  tablet.  An  ASCII  (dumb)  terminal 
with  keyboard  is  optional  for  some  hardware  platforms,  but  is  recommended  so  that  the  graphics  moni¬ 
tor  is  dedicated  to  display  during  the  digitizing  session.  Qirrently,  v.digit  drivers  have  been  written  for 
Altek,  Calconrp,  GeoGraphics,  Hitachi,  Kurta,  Numonics,  and  SummaGraphics  digitizers,  v.digit  also 
operates  in  an  X  Windows  environment.  An  X-interface  to  all  GRASS  programs  is  currently  under 
development. 

It  is  assumed  that  the  user  is  familiar  with  the  UNIX  environment,  GRASS,  and  in  particular  with  the 
concepts  of  vector  maps,  raster  maps,  map  layers,  geographic  regions,  reference  frames,  and  GRASS 
locations  and  mapsets.  For  a  review  of  these  concepts  refer  to  At  Introduction  to  GRASS  4  (Westervelt 
and  Goran,  1991). 

Experienced  GRASS  users  should  note  that  the  map  development  modules  used  in  GRASS  4.0  are 
essentially  the  same  as  their  predecessors,  with  some  minor  modifications  and  function  enhancements. 
Program  names  incorporate  the  new  prefix  standard  adopted  for  GRASS  4.0;  see  GRASS  4.0  Programs 
(Westervelt,  Martin,  and  Brinegar,  1991)  for  a  synopsis  of  this  naming  scheme.  GRASS  4.0  programs 
used  for  map  development  include: 

v.digit,  v  .import,  v.support,  vjnaiscii,  v.out.ascii,  ;uid  v.tojast 

These  programs  arc  discussed  in  detail  in  the  GRASS  4.0  User's  Reference  Manual  (Westervelt, 
Shapiro,  el  id.,  1991). 
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3.  PREPARING  A  MAP  FOR  DIGITIZING 

Frequently,  map  data  cannot  be  digitized  directly  from  original  source  maps.  Paper  maps  may  contain 
wrinkles,  creases,  or  tears.  Heat  and  humidity  cause  shrinking  and  swelling  of  unstable  media  which 
can  adversely  affect  the  accuracy  of  the  digital  representation.  Also,  analog  maps  generally  contain 
many  types  of  thematic  information.  The  analyst  must  know  exactly  what  map  features  are  to  be  digi¬ 
tized  To  avoid  confusion,  the  user  may  need  to  prepare  a  separate  map  or  maps  containing  only  those 
features  relevant  to  the  database  before  digitizing.  See  Cartographic  Issues  in  the  Development  of  a 
Digital  GRASS  Database  (Ruiz  and  Messersmith,  1990)  for  an  explanation  of  how  maps  should  be 
properly  prepared  for  digitizing,  and  section  5.1  of  this  tutorial  for  a  discussion  of  map  registration  and 
geo- referencing. 

The  following  items  should  be  considered  before  digitizing  commences: 

-  Use  a  stable  medium  (preferably  mylar,  plastic,  etc.)  on  which  the  features 
to  be  digitized  have  been  rendered  clearly  and  accurately. 

-  Use  drafting  tape  to  secure  the  medium  to  the  digitizii^  tablet. 

-  Define  a  geographic  region  in  a  standard  coordinate  system 
(UTM,  latitude/longitude,  etc.)  for  the  data  layer. 

-  On  the  medium,  locate  and  mark  at  least  four,  and  up  to  10,  coordinate  pairs 
(i.e.,  Fasting,  Northing)  to  be  used  as  map  registration  points. 

-  Define  a  reference  frame,  or  "digitizing  window,"  for  the  area. 

-  Have  another  map  of  the  area  available  for  reference. 

Affix  the  map  securely  to  the  digitizing  surface  with  drafting  tape,  making  sure  that  all  portions  of  the 
map  to  be  digitized  fall  within  the  "active"  area  of  the  board  and  within  the  reach  of  the  digitizing  cur¬ 
sor.  The  active  area  refers  to  that  portion  of  the  tablet  in  which  digitized  points  can  be  collected. 
(Most  digitizers  have  a  buffer,  or  "dead"  area,  near  their  edges  where  the  cursor  will  not  collect  points.) 
By  placing  the  map  to  be  digitized  near  the  center  of  the  board,  this  problem  can  be  avoided.  For 
extremely  large  maps  that  extend  beyond  the  active  area  of  the  digitizing  tablet,  the  map  may  have  to 
be  digitized  in  pieces;  the  user  must  provide  a  set  of  map  registration  points  for  each  map  piece.  The 
map  should  be  taped  down  with  the  sides  approximately  parallel  to  the  bottom  and  sides  of  the  board. 
Most  digitizing  programs,  including  v .digit,  have  transformation  algorithms  that  will  adjust  for  small 
deviations  in  registration  between  the  map  coordinates  and  board  coordinates.  However,  if  the  maps  are 
severely  skewed  on  the  board,  then  inaccuracies  with  registration  and  subsequent  collection  of  point 
coordinates  will  occur. 
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4.  USING  THE  MOUSE  AND  THE  DIGITIZING  CURSOR 

Many  v.digit  options  make  use  of  a  pointing  device  (mouse).  A  mouse  usually  has  three  buttons:  left, 
center,  and  right.  (Some  mice  may  have  only  two  buttons;  in  these  cases,  use  of  the  middle  butt  chi  is 
usually  emulated  by  pressing  the  left,  then  right,  mouse  buttons  in  quick  succession.)  Once  the  mouse  is 
activated,  movement  of  the  mouse  corresponds  to  movement  of  a  pointer  on  the  graphics  monitor 
screen.  In  v .digit,  the  pointer  appears  as  a  movable  box  or  an  arrow  depending  on  the  function 
specified  by  the  user.  Movement  of  the  mouse  is  used  to  identify  an  object  or  to  define  an  area  shown 
on  the  monitor.  Most  v .digit  operations  using  the  mouse  follow  a  left-right  sequence  for  first  choosing, 
and  second,  accepting  the  functions.  In  most  functions,  the  middle  button  ends  or  aborts  use  of  the 
mouse. 

Digitizing  is  the  process  of  converting  analog  map  data  into  digital  form  by  tracing  the  desired  features 
with  a  digitizer  cursor,  sometimes  referred  to  as  a  "puck."  The  cursor  consists  of  a  transparent 
viewfinder  or  "sight"  and  a  pad  containing  a  set  of  buttons  or  keys.  Generally,  the  sight  is  a  clear  plas¬ 
tic  lens  on  which  two  perpendicular  intersecting  fines  or  concentric  circles  are  superimposed,  llie  keys 
are  labeled  with  letters  and/or  numbers  that  correspond  to  various  functions  within  the  digitizing  pro¬ 
gram.  The  user  looks  through  the  sight,  much  as  with  a  rifle  scope,  to  target  the  appropriate  feature  to 
lie  digitized,  and  presses  the  keys  to  execute  the  appropriate  digitizing  function. 


5.  ENTERING  v .digit 

To  use  v .digit,  the  user  must  be  in  GRASS  4.0  and  have  entered  the  proper  LOCATION ,  MAPSET,  and 
DATABASE  in  which  to  work.  Help  with  the  start-up  procedure  and  a  full  explanation  of  these  terms 
are  available  in  the  GRASS  4.0  User’s  Reference  Manual  (Westervelt,  Shapiro,  et  al.,  1991). 

Once  in  the  proper  mapset,  the  user  sees  a  GRASS  default  prompt  similar  to  the  one  below. 


Mapset  <grassuser>in  Location  <Somewhere> 
GRASS  4.0  > 


After  the  prompt,  initiate  the  v.digit  program  by  entering  the  command: 


The  fust  message  to  appear  upon  entering  v.digit  is  a  list  of  the  AVAILABLE  DIGHTZERS  (i.e., 
those  for  which  device  drivers  have  been  installed  on  the  system).  See  the  sample  screen  below. 


Available  Digitizers 


Name: 

Description: 

[1] 

acme 

Acme  digitizer 

[2] 

none 

Rim  digit  without  the  digitizer. 

Hit  return  to  use  digitizer  in  brackets  below 
or  type  in  number  or  name  of  other  digitizer. 

Select  digitizer  [none]  :  1 


Selected  digitizer  is:  acme 


The  v.digit  program  operates  cither  with  or  without  use  of  a  digitizing  board.  Most  program  operations 
are  the  same  in  both  modes;  in  the  latter  case  the  mouse  then  serves  as  the  default  digitizing  instrument. 
The  user  has  the  option  of  using  the  program  without  the  digitizing  board  by  selecting  the  option  [2] 
none.  However,  for  the  purposes  of  this  manual,  the  user  should  start  by  working  with  a  digitizing 
tablet.  Enter  the  number  for  the  appropriate  digitizer  at  the  prompt  (here,  the  fictitious  "acme"  brand)  -- 
more  than  one  digitizer  may  be  available  for  selection.  If  a  digitizer  has  been  previously  used,  it  is 
saved  as  the  default  option  and  appears  named  in  the  brackets  next  time  v.digit  is  nut. 

Next,  the  user  is  prompted  for  the  name  of  tin-  VECTOR  map  to  be  used  during  the  current  digitizing 
session.  'Hie  user  has  the  option  to  create  a  new  file  or  to  nuxlify  an  existing  file.  If  the  name 
specified  is  not  found  among  the  existing  files,  the  program  assumes  that  the  user  wants  to  create  a  new 
file  and  asks  for  confirmation  of  the  new  file  name.  In  the  following  example,  the  file  lest  is  created. 
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Enter  the  name  of  a  map  to  work  with. 

If  name  is  entered  that  does  not  already  exist,  it 
will  be  created  at  this  time. 

DIGIT  FILENAME 

Enter  ’list’  for  a  list  of  existing  digit  files 
I  fit  RETURN  to  cancel  request 
>test 

<test> 

You  requested  to  create  new  file:  ’test’.  Is  this  correct?  (y/n)  [n]  y 


The  user  is  next  asked  if  the  vector  file  chosen  is  georeferenced  in  the  current  LOCATION’S  coordinate 
system.  In  this  manual,  the  Universal  Transverse  Mercator  (UTM)  is  used  as  the  sample  coordinate 

system. 


Current  mapset  is  UTM. 

Is  this  map  in  UTM  meters?  (y/n)  [y]  y 
Thank  You 

Creating  a  new  vector  file 


Other  coordinate  systems  that  can  be  used  include  an  arbitrary  (x,y),  latitude-longitude,  and  State  Plane. 
In  general,  GRASS  does  not  currently  pennit  the  user  to  mix  data  stored  in  different  coordinate  systems 
under  a  single  LOCATION  directory.  However,  other  GRASS  programs  do  enable  data  within  a  single 
IjOCATTON  to  be  converted  to  and  from  various  coordinate  systems  (eg.,  v .transform,  etc.).  In 
v.digit,  if  the  user  chooses  a  coordinate  system  other  than  the  one  originally  specified  for  the  user’s 
current  GRASS  IjOCATTON,  the  program  responds  with  the  following  warning  message  and  automati¬ 
cally  returns  to  the  GRASS  prompt: 


Sorry,  GRASS  docs  not  currently  support  mixing  map  units. 


If  the  coordinate  systems  arc  not  the  same,  then  some  type  of  coordinate  transformation  needs  to  lx 
performed.  'Hie  user  should  lx  aware  of  the  coordinate  systems  of  the  maps  being  considered.  Refer  to 
the  GRASS  program  g.help  and  to  Ruiz  and  Messersmith,  1990  for  a  discussion  of  map  coordinate  sys¬ 
tems,  projections,  and  data  conversions. 
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The  next  screen  appears: 

Provide  the  following  information: 

Your  organization  US  Army  Const.  Eng.  Rsch.  Lab 

Todays  date  (mon,yr) _ 

Your  name _ 

Map’s  name _ 

Map’s  date _ 

Map’s  scale _ 

Other  info _ 

Zone _ 

West  edge  of  area  590000 _ 

South  edge  of  area  4941000 _ 

East  edge  of  area  609000 _ 

North  edge  of  area  4928000 _ 

_ AFTER  COMPLETING  ALL  ANSWERS,  HIT  <£SC>TO  CONTINUE 


This  screen  contains  information  about  the  vector  file.  A  newly  created  layer  initially  contains  several 
blank  lines.  The  coordinates  on  this  page  define  a  "digitizing  region";  they  are  automatically  entered 
and  are  originally  derived  from  the  default  region  coordinates  in  the  PERMANENT  mapset  for  the 
present  LOCATION.  The  user  can  find  the  default  region  coordinates  by  executing  the  GRASS  com¬ 
mand  g. region  -dp  prior  to  entering  the  v .digit  program.  The  user  should  be  careful  to  make  sure  that 
this  region  incorporates  the  area  of  the  new  vector  file;  generally,  the  default  is  more  than  adequately 
large.  Remember,  too,  that  data  physically  can  be  digitized  outside  of  the  default  region  but  it  will  not 
be  visible  to  the  user  unless  the  region  is  expanded  to  include  it.  A  sample  screen  with  the  categories 
filled  in  is  presented  below;  use  the  Enter/Retum  key  to  move  around  the  screen: 


Provide  the  following  information: 

Your  organization 

USA-CERL 

Todays  date  (mon,yr)  1KA/91 

Your  name 

U.D.  Grassuser 

Map’s  name 

Test  for  v. digit 

Map’s  date 

1991 

Map’s  scale 

1:24000 

Other  info 

USGS  topo,  1  of  2 

Zone 

13 

West  edge  of  area 

590000.00 

South  edge  of  area 

4941000.00 

East  edge  of  area 

609 000.00 

North  edge  of  area 

4928000.00 

AFTER  COMPLETING  ALL  ANSWERS,  HIT  <£SC>TO  CONUNUE 

After  typing  in  the  relevant  information  on  this  screen,  press  the  <E.SCAPE>  key  to  continue  the  digi¬ 
tizing  session. 
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The  following  message  appears: 


Shall  we  continue?  [y] 
Writing  plus  file  . . . 


Press  the  Enter/Retum  key  to  continue.  The  string  "Writing  plus  file  .  .  means  that  a  dig_plus  file  is 
being  created  for  the  new  vector  file.  This  file  pertains  to  the  spatial  topology  of  the  vector  data  to  be 
created  and  references  the  vector  data  to  the  appropriate  coordinate  system.  Once  created,  the  dig_plus 
files  are  not  directly  modifiable  unless  the  vector  file  is  changed  using  other  options  (eg.,  v -support). 
This  message  does  not  appear  if  a  previously  created  vector  file  is  chosen.  Answering  "no"  (or  simply 
”ri’)  at  this  time  exits  the  user  from  v.digit.  Ifowever,  the  header  information  entered  at  the  beginning 
of  the  current  session  will  be  saved. 

5.1.  REGISTERING  THE  MAP 

The  next  step  is  to  georeference  the  map  to  a  particular  geographic  coordinate  system  (i.e.,  to  the  coor¬ 
dinate  system  previously  specified  by  the  user-here,  UTM).  This  is  done  by  selecting  a  series  of  regis¬ 
tration  points,  a  convenient  source  of  which  is  the  intersection  of  UTM  grid  lines.  Some  U.S.  Geologi¬ 
cal  Survey  (USGS)  75’  quad  sheets  (1:24000  scale)  and  most  Defense  Mapping  Agency  (DMA)  instal¬ 
lation  maps  (1 50000  scale)  have  these  grids  inscribed  on  them.  However,  most  USGS  quads  only  have 
the  UTM  grid  ticks  demarcated  along  the  border  of  the  map.  In  the  latter  case,  the  user  has  to  use  a 
straightedge  and  pencil  to  carefully  draw  in  the  grid  intersection  for  each  point.  Sometimes  the  analyst 
is  confronted  with  a  map  in  which  no  arbitrary  coordinate  grid  is  represented,  or  maps  of  less  than 
superior  quality  (such  as  a  photocopy  or  blue-line  drawing).  In  such  cases,  the  analyst  may  have  to 
derive  registration  points  from  other  maps  by  cross-registering  the  "bad"  map  to  the  "good"  map  (e.g., 
using  obvious  physical  features  visible  on  both  maps  such  as  road  intersections,  bench  marks,  etc.).  This 
can  be  a  tedious  and  frustrating  endeavor;  the  registration  process  often  involves  more  than  a  little  bit 
of  ingenuity  and  persistence  on  the  part  of  the  analyst. 

If  this  vector  file  has  been  worked  on  in  GRASS  before,  a  file  of  registration  points  with  this  same  file 
name  will  already  have  been  created  and  be  stored  in  the  reg  directory  in  the  mapset  of  the  user  who 
created  the  file.  If  the  user  specifies  the  name  of  an  existing  file,  the  program  automatically  accesses 
the  registration  points  that  were  used  in  the  last  digitizing  session.  The  user  may  use  these  same  regis¬ 
tration  points,  add  additional  ones,  or  choose  completely  new  points  in  the  current  session,  as  shown 
Ixlow.  See  Ruiz  and  Messcrsmith,  1990,  lor  a  more  detailed  discussion  of  registration  points.  (If  this 
is  a  new  file,  the  user  will  NOT  see  the  following  message.) 


Use  set  of  registered  points  from  last  session  (y/n)? 


Inter  y  to  use  the  same  registration  |>  lints  as  in  the  previous  session,  or  enter  n  to  register  the  map 
using  new  points.  The  following  screen  apixxirs: 
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M^P  REGISTRATION  POINTS 
Enter  4-10  points  :  points  registered  0 


Point  #  X  coord  Y  coord 

1  590000.00 _  4915000. 00_. 

2  590000.00 _  4927000. 00_ 

3  599000.00 _  4927000. 00_ 

4  599000.00 _  4915000. 00_ 

5  0.00 _  0.00 _ 

6  0.00 _  0.00_ _ 

7  0.00 _  0.00 _ 

8  0.00 _  0.00 _ 

9  0.00 _  0.00 _ 

10  0.00 _  0.00 _ 


Enter  0.0  to  delete  a  coordinate  set. 

Those  marked  by  are  registered. 

AFTER  COMPLETING  ALL  ANSWERS ,  HIT  <£SO  TO  OCNTINUE 
(CR  Ctrl  -C>  TO  CANCEL) 


Reading  from  the  map,  type  in  the  (x,y)  coordinates  for  each  registration  point  using  the  keyboard. 
Move  through  the  list  (alternate  x,y  pairs)  by  entering  <RETURN>.  Remember,  in  most  cases  X  refers 
to  [UIM]  EASTINGS  and  Y  to  [UIM]  NORTHINGS.  v.digit  requires  that  at  least  four  points  be 
registered;  ten  points  are  the  most  that  may  be  entered.  It  is  a  good  practice  to  enter  as  many  registra¬ 
tion  points  as  possible  since  some  points  will  probably  have  to  be  eliminated  because  of  accuracy  prob¬ 
lems.  These  points  are  used  to  construct  a  surface  grid  system  for  the  map.  The  points  should  be  dis¬ 
tributed  throughout  the  map  to  avoid  amplifying  accuracy  errors  that  can  be  caused  by  choosing  points 
clustered  closely  together  over  a  relatively  small  (and  perhaps  unrepresentative)  section  of  the  map  area 
being  registered. 

Also,  it  is  convenient  to  enter  the  coordinates  in  some  order;  again,  each  analyst  will  have  his/her  own 
style  for  executing  these  tasks.  For  example,  begin  by  entering  the  coordinates  of  the  registration  point 
nearest  the  lower  left  (usually  southwest)  comer  of  the  map,  and  continue  entering  points  in  a  clockwise 
direction  until  all  of  the  coordinates  are  entered.  In  this  example,  as  is  common  practice,  a  USGS  7.5’ 
quad  sheet  has  been  used  to  select  the  registration  points.  Only  four  registration  points  are  used  in  this 
case.  Note  the  progression  in  the  direction  of  the  UIM  (x,y)  coordinate  pairs  from  the  lower  left  to  the 
lower  right  comer  of  the  map. 

Once  the  user  has  finished  entering  the  coordinates  of  the  registration  pants,  and  double-checked  them 
for  typing  errors,  press  the  <£SCAPE>  key  to  continue.  These  first  four  points  can  be  used  to  construct 
a  map  neatline.  See  section  13  (The  Toolbox  Menu)  for  a  discussion  of  this  feature.  The  next  screen 
appears: 
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POINTS  TO  REGISTER 

POINT 

EASTING  (X) 

NCKIHING  (Y) 

>  1 . 

590000.00 

4915000.00 

2. 

590000.00 

4927000.00 

3. 

599000.00 

4927000.00 

4. 

599000.00 

4915000.00 

Number  of 

points:  4,  Toints 

registered: 

USING  DIGITIZER  CLRSCR  FCR  INPUT 

Key<0>  -  register  point  Key<3>  -  add  more  points 

Key<i>  -  skip  point  Key<4>  -  accept  residuals 

KeyC>  -  unregister  point 


This  screen  displays  options  which  deal  with  the  registration  points.  Depending  on  the  brand  of  digi¬ 
tizer  used,  the  screen  may  look  slightly  different  than  shown  above.  The  numbers  in  brackets  at  the 
bottom  of  the  screen  refer  to  numbered  keys  or  buttons  on  the  digitizer  cursor. 

To  register  a  point,  locate  the  button  labeled  ”<0^'  on  the  cursor.  Sight  the  cross  hair  of  the  cursor 
over  the  first  point  to  be  registered  and  press  "<0^'.  As  each  point  is  registered,  an  asterisk  (*)  appears 
to  the  left  of  it.  The  program  also  emits  an  audible  "BEEP*  to  let  the  user  know  the  point  has  been 
collected.  Once  a  point  is  registered,  v.digit  automatically  proceeds  to  the  next  point.  Enter  "<15*'  on 
the  cursor  to  skip  any  point.  If  a  mistake  has  occurred,  you  can  press  "<25*’  to  unrcgister  inaccurate 
points  so  that  they  can  be  reregistered  or  removed  from  consideration  altogether.  If  more  registration 
points  are  needed,  choose  "<35*'  and  type  in  the  coordinates  of  the  additional  points. 

Once  a  minimum  of  four  points  is  registered,  a  fourth  column  (RESIDUALS)  appears  on  the  right  side 
of  the  screen  listing  the  residual  error  associated  with  each  point: 
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POINTS 

TO  REGISTER 

POINT 

EASTING  (X) 

hCRTHING  (Y) 

RESIDUALS 

>  * 

1. 

590000.00 

4915000.00 

1.79 

* 

2. 

590000.00 

4927000.00 

1.79 

* 

3. 

599000.00 

4927000.00 

1.79 

* 

4. 

599000.00 

4915000.00 

1.79 

Number  of  points:  4,  Points  registered:  4 
Residual  mean  average  :  1.794367 


USING  DIGITIZER  CURS®  FUR  IMTJT 

Key<0>  -  register  point  Key<?>  -  add  more  points 

Key<l>  -  skip  point  Key<4>  -  accept  residuals 

Key<2>  -  unregister  point 


The  residual  is  a  statistical  measure  that  indicates  the  accuracy  of  each  registration  point  in  relation  to 
the  others.  In  this  case,  the  units  are  expressed  as  the  number  of  meters  of  deviation.  The  magnitude 
of  the  residual  error  is  based  on  the  original  scale  of  the  map  being  digitized.  (Ruiz  and  Messersmith, 
1990  gives  a  more  detailed  explanation.)  For  example,  as  a  general  rule  of  thumb,  for  a  standard  USGS 
7.5’  quad  sheet  (1:24000  scale),  the  overall  residual  normally  should  be  less  than  9  and  ideally  less  than 
3.  (Ruiz  and  Messersmith,  1990  also  gives  other  examples  and  a  more  extended  discussion  of  residu¬ 
als.)  Each  individual  residual  should  fall  within  two  integers  of  the  other  residuals  listed.  Residuals 
can  often  be  lowered  by  re  gistering  points  ("<©:>’),  by  eliminating  specific  points  ("<2:>),  or  by 
adding  new  points  ("<3>').  Once  the  residuals  appear  satisfactory,  choose  "<4:>  to  continue.  (As 
explained  above,  the  selected  points  are  saved  in  a  file  and  can  be  used  to  re-register  the  map  in  a  sub¬ 
sequent  digitizing  session.)  The  following  screen  appears: 
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This  screen  is  used  to  verify  that 
Check  known  points  on  the  map  with 
with  the  coordinates  at  the  bottom 


the  map  registration  is  correct, 
the  digitizer  and  compare  them 
of  this  screen. 


CHECK  MAP:  Key  ’0’  to  preserve  point;  Any  other  Key  to  continue 

Coordinates:  X  -  Current  -  Y  X  -  Saved  -  Y 

0  595281.67  492082.36  0.00  0.00 


GRASS  uses  the  registration  points  the  user  has  input  and  accepted  to  coastmct  an  entire  surface  coor¬ 
dinate  system  for  (lie  user’s  map.  (It  "registers"  the  map’s  surface  coordinates  to  the  digitizing  tablet's 
surface  ccxirdinates.)  The  user  can  test  the  accuracy  of  the  georeferencing  based  on  these  registration 
points  by  using  the  screen  fiuiction  shown  directly  above.  The  user  points  to  sites  with  user-known 
geographic  coordinates  on  the  paper  map,  and  notes  the  digitizer  coordinates  corresponding  to  these 
points  listed  in  the  "Current"  column;  the  user-known  map  coordinates  should  approximate  the  com¬ 
puted  coordinate  values  listed  in  the  "Current"  column.  Note  that  as  the  digitizer  cursor  is  moved  the 
coordinates  under  the  "Current"  heading  constantly  change.  Pressing  "<!(;>  temporarily  freezes  the 
coordinates  of  that  point  until  the  key  is  pressed  again.  This  option  may  also  lie  useful  when  register¬ 
ing  two  maps  to  one  another,  such  as  a  quad  sheet  and  a  photocopy  without  coordinates.  'Hie  locations 
of  identifiable  features  on  the  photocopy  can  be  pinpointed  on  the  quad  sheet  and  subsequently  used  as 
registration  points  for  the  phot  (copy  version.  (Unfortunately,  the  coordinates  will  have  to  lie  written 
down  since  it  is  not  possible  to  save  them  directly  to  a  file.)  Pressing  any  key  other  than  "<0:> 
proceeds  to  the  next  command  screen. 


USINi  DIGITIZER  CURSOR  HR  INPUI 
Key  ’0’  for  YES  :  Key  ’  1  ’  for  N) 

If  sa  t  i  sited  wi  t  h  the  registration,  enter  ’v’,  else  ’n’ 


'Ibis  screen  asks  the  user  to  verify  that  the  registration  is  satisfactory  and  to  respond  by  using  one  of  the 
designated  cursor  keys.  Pressing  ”<!;>  sends  the  user  back  to  the  registration  screen,  and  "<0:> 
accepts  the  piints  that  were  entered. 

5.2.  DEFINING  THE  WORKING  WINDOW 

At  this  point,  the  user  has  entered  v.digit,  registered  the  map,  and  is  almost  ready  to  begin  digitizing. 
Ihe  "digitizing  region"  that  was  created  earlier  (defined  by  the  default  region  coordinates  or  others 
typed  in  the  dig  file  header  entered  by  the  user  just  alter  entering  v .digit)  is  probably  too  large  an  area 
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in  which  to  work  comfortably.  The  user  now  defines  a  "working  window"  as  a  subset  of  the  "digitizing 
region."  This  conforms  to  the  area  displayed  cm  the  graphic  screen,  and  the  parameters  can  be  changed 
repeatedly  throughout  the  v.digit  session  (eg.,  using  the  Zoom  or  Window  Menus).  The  working  win¬ 
dow  does  not  affect  any  other  GRASS  program,  nor  is  it  saved  after  the  user  exits  v .digit.  It  exists 
only  to  provide  graphic  reference  and  to  display  small  areas  in  which  the  user  is  focusing  work. 

Understanding  the  differences  between  the  "digitizing  region,"  "working  window,"  "default  region,"  and 
"current  region"  is  important.  If  necessary,  review  these  concepts  before  continuing  (see,  for  example, 
explanations  accessed  through  the  GRASS  4.0  giielp  program). 

Use  the  digitizer  cursor  to  pick  two  points  on  the  map  diagonal  from  each  other  to  define  the  "working 
window"  slightly  outside  the  perimeter  of  the  map  image.  The  next  two  command  screens  appear  in 
succession.  For  example,  choose  the  lower  left  (southwest)  and  upper  right  (northeast)  comers  of  the 
area. 


Identify  corners  of  graphics  window. 

Ix>cate  digitizer  cursor  on  one  corner  of  de  s  i  red  wi  ndow . 
Then  hit  any  digitizer  <KEY> 


When  a  KEY  is  depressed,  the  user  hears  a  "BEEP'  confirming  the  selection. 


Now  place  digitizer  cursor  on  diagonal  corner  of  desired  window. 
Ilicn  hit  any  digitizer  <KFY> 


After  choosing  the  second  point,  another  "BEEF'  is  emitted,  and  the  program  enters  the  v.digit  menu. 
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6.  THE  MAIN  MENU 

After  the  "working  window"  is  selected,  the  v .digit  program  enters  the  Main  Menu.  The  Main  Menu 
serves  as  the  entry  and  exit  menu  for  all  functions  pertaining  to  vector  data  entry  and  modification. 
The  layout  of  the  Main  Menu  screen  appears  below: 


1 

|  GRASS -DIGIT  Version  4.0 

i _  _ 

Main  Menu 

|  MSP  INFdMSXICN 

|  AMXNT  DIGITIZED 

!  Name : 

Test,  v.digit  manual 

|  #  Li nes  : 

0 

|  Scale: 

24000 

i  #  Area  edges  : 

0 

|  Person: 

U.D.  Grassuser 

|  #  Si tes : 

0 

|  Dig.  Thresh: 

0.0300  in. 

1 . . 

|  Map  Thresh . : 

18 .290  meters 

|  Total  points: 

1 

0 

\  OPTICNS : 

1 

1 

|  Digitizer: 

Enabled 

1 

Digitize  Fdi  t  label  Customize  Toolbox  Window  Help  Zoom  Quit  *  ! 
(iLCBAI.  MI-MJ:  Press  first  letter  of  desired  comnand.  [Upper  Case  Only] 


6.1.  MAIN  MENU  OPTIONS 

v.digit  is  composed  of  a  hierarchy  of  menus,  each  of  which  is  composed  of  a  number  of  fields  describ- 
ing  the  menu  functions  ;uid  options.  flic  top  field,  or  the  TITLE  field,  displays  the  version  of 
GRASS- DIGIT  being  used  and  the  name  of  the  currently  selected  menu. 

The  MAP  INFORMATION  field  is  extracted  from  the  header  information  typed  in  by  the  user  upon 
first  entering  the  digitizing  session.  It  provides  a  quick  reference  to  the  user  and  also  provides  the 
current  status  of  the  digitizing  and  map  thresholds  currently  selected  (see  the  Customize  Menu  for  an 
explanation  of  what  the  thresholds  mean).  This  field  apjiears  only  on  the  Main  Menu. 

The  AMOUNT  DIGITIZED  field  shows  the  status  of  tire  amount  of  each  type  of  feature  (i.c.,  liix\ 
area,  or  site)  that  has  been  digitized  and  the  total  numlxr  of  points  comprising  these  features.  This  field 
appears  only  on  the  Mam  and  Digitize  Menus. 

The  OPTIONS  field  lists  the  functions  available  to  the  user  in  any  given  menu.  In  the  Main  Menu,  it 
shows  the  status  of  tire  digitizing  device  lving  used;  here,  it  is  the  digitizer  that  is  enaNed.  If  no  digi¬ 
tizer  had  lx:cn  selected  lor  use',  this  field  would  state:  Digitizer:  Disabled  (see  the  (unionize  Menu 
options  on  how  to  toggle  the  digitizing  device). 

The  GLOBAL  MENU  (bit tom  field)  shows  the  other  menus  available  to  the  user  through  the  currently 
selected  menu.  Use  the  KEY1K  )ARI)  to  select  ;m  alternate  menu  by  typing  in  the  first  letter  (UPPER 
CASE).  Global  Menu  options  may  be  chosen  only  when  they  appear  on  the  current  menu  page.  Onlv 
one  menu  is  available  for  use  at  any  given  time.  Six  options  appearing  in  the  Global  Menu  field  at  the 
Ixittom  of  the  Mam  Menu  refer  to  specific  submenus:  Digitize,  lulu,  label.  Customize,  toolbox,  and 
Window. 
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There  are  six  Main  Menu  global  options  that  are  not  menu  names: 

Zoom  allows  the  user  to  zoom  or  pan  over  the  vector  layer.  Since  this  is  a  significant  function, 
however,  it  is  discussed  in  a  separate  section. 

Help  displays  menu- specific  interactive  help  to  the  user. 

Quit  exits  the  user  from  the  current  v .digit  session  and  automatically  saves  any  work  completed 
during  this  time.  This  option  is  available  only  from  the  Main  Menu. 

The  asterisk,  ”*",  refreshes  the  terminal  screen. 

The  exclamation  sign  (or  bang),  "!",  refreshes  the  graphics  screen.  When  executed,  the  following 
message  appears  in  the  global  field: 


Wait.  Replotting  the  Screen. 

.  .  .  Press  <£SC>key  to  stop  redraw 


The  screen  is  erased,  and  any  digitized  lines  will  begin  to  be  redrawn.  Pressing  the  <ESCAPE>  key 
stops  the  redraw  at  that  point,  and  allows  the  user  to  use  other  options.  This  is  especially  useful  for 
large  files  such  as  soils,  contour  lines,  or  others  where  it  would  be  inconvenient  to  wait  for  the  entire 
file  to  redisplay. 

I  he  carat,  "  ”,  is  used  to  unlock  the  monitor  when  changing  (back  and  front)  between  the  digitizing 
(graphic)  and  (shell)  windows  on  SUN  workstations.  If  the  monitor  should  lock  up,  pressing  the  carat 
several  times  should  release  it.  This  feature  also  works  on  X  terminals. 

Help,"*","!",  and  "  ",  are  available  from  any  menu. 

Before  actually  entering  D  to  digitize,  try  moving  through  the  other  menus.  Notice  that  the  global 
options  available  within  each  submenu  are  slightly  different  than  the  ones  available  in  the  Main  Menu. 
To  reiterate,  remember  that  typing  the  first  letter  of  any  of  the  available  options  causes  the  current 
option  to  be  replaced  with  the  new  option.  When  comfortable  with  the  menu  and  option  structure, 
proceed  to  the  next  section. 
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7.  THE  DIGITIZE  MENU 

The  Digitize  Menu  is  where  the  actual  input  of  vector  data  occurs.  It  is  accessible  from  the  Main,  Edit, 
and  label  Menus.  The  following  sections  describe  first  die  use  of  the  digitizing  cursor  for  data  input, 
followed  by  the  use  of  the  mouse  (see  also  the  Customize  Menu  in  section  10).  The  screen  layout  of 
the  Digitize  Menu  with  the  default  parameters  is  shown  below: 


7.1.  DIGITIZE  MEM'  FIELDS  AND  OPT  IONS 

The  menu  has  four  display  fields,  which  provide  the  user  reference  information,  function  options,  and 
interactive  inspections.  The  UPPER- 1, ITT  field  identifies  whether  (fie  mouse  or  digitizer  is  selected, 
and  if  the  latter,  the  brand  of  digitizer  being  used  (here  the  fictitious  "ACME  digitizer'1).  It  also 
descrilvs  the  digitizer  cursor  functions,  bach  numlxT  within  brackets  refers  to  the  corresponding  key 
on  the  cursor: 

<0  >  Digitize  Point 

Activates  the  digitizer  for  the  collection  of  points. 

<1  >Quit  Digitizing 

Terminates  the  collection  of  jx>ints. 

<2>U|xliite  Monitor 

VMien  iligilizing  in  ST  REAM  mode,  points  are  continuously  collected  until  the  user  quits  digitiz¬ 
ing  or  toggles  to  POINI  mode,  and  the  vector  Ixiug  digitized  dtx\s  not  appear  on  the  graphics 
display  monitor  until  the  user  has  quit  digitizing.  This  kev  temporarily  suspends  the  collection  of 
p'ints  during  digitizing  and  displays  the  line  drawn  on  the  graphics  display  monitor  up  to  the 
|x lint  last  digitized.  (See  the  discussion  of  point  ;uu!  stream  iikxIcs  IxTow  ami  on  the  following 
page.) 
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<3>Toggle  Point/Stream  Mode 

Allows  the  user  to  switch  between  POINT  and  STREAM  modes  without  having  to  interrupt  digi¬ 
tizing  and  switch  to  the  keyboard.  This  function  is  useful  for  "on-the-fly"  digitizing  of  more 
complex  features  having  a  combination  erf  straight  and  curvilinear  segments. 

The  UPPER-RIGHT  field  is  entitled  "AMOUNT  DIGITIZED.”  It  refers  to  the  number  of  lines,  areas, 
and  sites  digitized  (see  below),  and  the  number  of  points  used  to  represent  these  objects  based  on  the 
digitizing  thresholds  specified  (see  the  Custonize/Display  Menus  described  in  sections  10  and  12). 
These  numbers  are  continually  updated  to  reflect  changes  in  the  features  that  have  been  digitized. 

The  LOWER-RIGHr  field  entitled  "CURRENT  DIGITIZER  PARAMS"  displays  the  status  of  the  digi¬ 
tizing  parameters.  Digitizing  can  occur  either  in  POINT  or  STREAM  mode  (see  below).  Features  are 
represented  either  as  a  LINE,  AREA  EDGE,  or  SITE  (see  below).  The  parameters  currently  set  are 
CAPITALIZED  and  bracketed  (>  <).  The  default  parameters,  shown  here,  are  ">8TREAM<r  mode  and 
">AREA<C  type.  The  "AutoLabel:"  parameter  allows  the  user  to  specify  a  category  value  for  features 
at  the  time  they  are  being  digitized  (see  belcw),  thus  eliminating  the  need  to  enter  the  Label  Menu, 
described  in  section  9. 

The  LOWER-LEFT  field  entitled  "DIGITIZE  OPTIONS"  contains  the  following  functions: 

<Space>  Digitize 

Pressing  the  <SPACE  BAR>  on  the  keyboard  activates  the  digitizer  to  start  the  collection  of 
points. 

m  -  Toggle  MODE 

Selects  between  the  two  modes  of  collecting  points  during  digitizing:  STREAM  or  POINT. 

In  POINT  mode,  the  digitizer  collects  pants  only  when  the  user  pushes  the  <0>  key  on  the  cur¬ 
sor,  that  is,  individually,  one  point  at  a  time.  Point  mode  is  used  for  digitizing  straight  lines  and 
simple  features  where  the  shape  requires  only  a  small  number  of  points  to  accurately  define  it 
(i.e.,  straight  roads  or  boundaries,  section  lines,  site  loci,  etc.). 

In  STREAM  mode,  once  the  <0>key  is  depressed,  the  digitizer  continually  collects  points  as  the 
cursor  is  moved.  Stream  mode  is  used  when  digitizing  curves,  complex  lines,  and  other  features 
where  frequent  collection  of  points  is  needed  to  capture  detail  (soil  polygons,  streams,  etc.). 

t  -  Toggle  TYPE 

Selects  Ire  tween  the  three  types  of  features  that  am  be  digitized:  LINE,  AREA  1DGE,  or  SHE. 
It  is  the  decision  of  the  analyst  and  her/his  supervisors)  to  agree  on  the  level  of  detail  required  to 
most  accurately  depict  the  feature  in  question. 

A  LINE  is  a  two-dimensional  feature  that  joins  two  points  together.  Features  such  ns  roads  and 
streams  are  usually  represented  as  lines. 

An  AREA  EDGE  is  a  line  failure  that  defines  a  perimeter,  border,  or  common  boundary  with 
other  areas.  Features  like  soil  polygons  are  digitized  as  area  edges. 

A  SITE  is  used  to  represent  a  point  locus.  Examples  may  include  features  such  as  archaeological 
sites,  endangered  species  locations,  artillery  firing  points,  etc. 

I  -  Auto  Label 

Toggles  between  the  method  of  labding  to  be  used.  The  default  is  DISABLED  (OFF)  and  the 
features  must  subsequently  be  labeled  using  the  label  Menu  (see  section  9).  When  turned  ON, 
the  user  can  specify  the  category  value  for  line  features  while  they  are  being  digitized.  The  auto 
label  method  status  (ON  or  OFT)  is  shown  on  the  Main  Digitize  Menu  under  CURRENT  DIGI¬ 
TIZER  PARAMETERS. 

q  -  Quit  to  main  menu 

Returns  to  the  Main  Menu. 
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72.  THE  DIGITIZING  PROCEDURE 

The  digitizing  procedure  varies  depending  on  the  kind  of  feature  being  digitized.  There  are  five  possi¬ 
ble  combinations  of  digitizing  parameters:  PONT/SITE,  POINT/LINE,  PC8NT/AREA  EDGE, 
STREAM/LINE,  and  STREAM/AREA  EDGE  Logically,  since  a  point  represents  only  a  singular 
locus,  it  would  not  be  used  with  the  STREAM  mode. 

Along  with  the  visual  cues  on  the  graphic  screen,  v .digit  also  wams  the  user  with  an  audible  "BEEF' 
when  further  action  must  be  taken.  Once  the  <SPACE  BAR>  on  the  keyboard  is  depressed,  the  Global 
Menu  field  shows  how  many  points  of  a  feature  have  been  collected,  and  the  UTM  coordinates  for  each 
respective  point.  In  STREAM  mode  these  coordinates  fly  by  rapidly.  In  the  following  examples, 
brackets  ([  ])  denote  comments  that  do  not  appear  on  screen. 

7.2.1.  POINT  MODE 

In  POINT  mode,  SITE  type,  data  collection  begins  as  soon  as  <ri>is  pressed.  The  sequence  is: 


<space  bar> 

[activate  digitizer] 

<0> 

[digitize  the  site] 

<1> 

[end] 

[repeat  next  site] 

<1> 

[exit] 

The  original  Digitize  Menu  fields  are  replaced  by  the  following  fields: 


Site  digitizing 

#  Points 

Easting 

Northing 

0 

0.00 

0.00 

POINT  mode 

When  the  <0>  key  is  depressed,  the  lasting  and  Northing  coordinates  flash  by  very  rapidly,  and  the  fol¬ 
lowing  query  appears: 


USING  DIGITIZER  CURSOR  FOR  INPUT 
Key  ’O’  for  YES  :  Key  T  for  NO 
NO  IE:  1  new  nodes  needed 
Do  you  accept  this  site? 


The  site  location  is  first  represented  on  the  graphic  screen  by  a  yellow  X.  (i.e.,  "X”  marks  the  spot). 
Check  back  and  forth  Ixitwecn  the  screen  and  the  map  to  sec  if  the  location  is  correct.  If  so,  press  <1)> 
again;  the  color  of  the  site  "X"  changes  from  yellow  to  green,  denoting  that  it  has  been  accepted. 
Rc|>eat  tlie  point  input  sequence  aUn  e  as  needed.  IVcss  <1  > to  completely  exit  point-nuxle  digitizing. 

In  POINT  mixlc,  in  cither  the  LINE  or  AREA  EJXiE  ty|x\s,  the  first  time  <0>is  pressed  activates  the 
program  to  receive  data.  The  second  time  <l»is  pressed  begins  the  collection  of  (Lata  points.  'Ilia!  is. 
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the  sequence  to  collect  points  is: 


<Space  bar> 

[activate  digitizer] 

o> 

[get  ready] 

<0> 

[start  digitizing  the  line] 

<1> 

[end] 

[repeat  next  line/area] 

<1> 

[exit] 

As  each  line  is  digitized  and  dosed,  the  segment  between  the  beginning  and  ending  nodes  is 
highlighted  in  yellow.  The  following  information  appears  where  the  Global  Mem  field  was  at  the  bot¬ 
tom  of  the  Digitize  Mem : 


#  Points  Easting  Northing 

0  0.00  0.00 

POINT  mode 


As  each  point  is  digitized,  its  sequence  number  (1,2,3,  etc.)  appears  under  the  "Points"  he;  lg  along 
with  the  UIM  coordinates.  After  ending,  the  following  query  appears  in  the  Global  Menu  field: 


USING  DIGITIZER  CURSOR  FOR  INPUT 

Key  ’0’  for  YES  :  Key  T  for  NO 

NOTE:  [0,1 ,2 1  new  nodes  needed 

Do  you  accept  this  area  line?  [if  an  area  edge] 

[or] 

Do  you  accept  this  line?  [if  a  line] 


The  number  of  nodes  needed  depends  on  how  the  line  relates  to  surrounding  lines — if  the  line’s  end¬ 
points  (i.e.,  nodes)  connect  (snap)  to  two  already  existing  nodes,  then  it  requires  no  additional  nodes;  if 
one  of  the  line’s  endpoints  is  snapped  to  an  existing  node  but  the  other  endpoint  is  not,  the  line  requires 
one  additional  node;  if  both  of  the  line’s  endpoints  are  open  and  not  snapped  to  existing  lxxles,  then 
two  new  nodes  are  needed. 

Check  the  map  and  graphics  screen  to  ensure  the  line  appetirs  correct.  When  accepted,  the  line  changes 
to  the  color  corresponding  to  its  topology  (see  the  Customize /C olor  Mem  described  in  sections  10  and 
11,  for  default  colors).  To  exit  completely  from  digitizing,  press  key  Oat  the  next  prompt: 


USING  DIGITIZER  CURSOR  FOR  INPUT 
Kev  ’0’  for  YES  :  Key  T’  for  NO 

Begin  digitizing? 
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12 2.  STREAM  MODE 

In  STREAM  mode,  LINE  or  AREA  EDGE  type,  data  collection  begins  as  soon  as  <0>is  pressed.  The 
sequence  is: 


<5pace  bar> 

[activate  digitizer] 

<t)> 

[start  digitizing] 

<3> 

[end] 

[repeat  next  line/area] 

<I> 

[exit] 

USING  DIGITIZER  CURSOR  FOR  INPUT 
Key  ’0’  for  YES  :  Key  T  for  NO 

Begin  digitizing? 


The  line  is  not  displayed  on  the  graphics  screen  until  digitizing  is  terminated,  unless  key  <2>  (update 
monitor)  is  used  (see  section  7,  The  Digitize  Menu).  As  each  line  is  closed,  the  segment  between  the 
beginning  and  ending  nodes  is  displayed  in  yellow.  After  ending,  the  following  query  appears  in  the 
CAobal  Menu  field: 


USING  DIGITIZER  CURSOR  TOR  INPUT 

Key  ’O’  for  YES  :  Key  ’1’  for  NO 

NOTE:  [0,1^]  new  nodes  needed 

IX)  you  accept  this  area  line?  [if  an  area  edge] 

for] 

IX)  you  accept  this  line?  [if  a  line] 


Check  between  the  map  and  the  graphics  screen  to  m;ikc  sure  the  line  appears  correct.  When  accepted, 
the  line  changes  to  the  color  corresponding  to  its  topohigy  (see  the  Customize /Color  Menus  shown  in 
sections  10  and  1 1  for  the  default  colors).  If  the  line  is  not  accepted,  it  is  erased. 

13.  DIGITIZING  WITH  TH1,  MOUSE 

The  mouse  can  also  lx:  used  to  perform  digitizing.  Normally,  the  mouse  will  be  used  primarily  to  add 
or  delete  lines  (e.g.,  edit).  It  can,  Itowever,  lx-  used  to  digitize  if  a  raster  (cell)  file  is  used  as  a  data 
Ixickdrop  (see  the  Customize  Menu  overlay  option).  Iliis  can  be  accomplished  in  one  of  two  ways: 
either  by  chcxising  to  use  no  digitizer  ("none")  when  lirsl  entering  the  v.digit  program  (see  section  5, 
Entering  v.digit),  or  by  entering  the  Customize  Menu  and  toggling  the  digitizing  instrument  from  the 
digitizer  to  the  mouse  (sec  section  10).  I  he  first  alternative  is  explained  in  more  detail  here.  If  the  use 
of  the  mouse  is  selected,  then  this  fact  is  displaced  in  the  upper-left  field  of  the  Digitize  Menu  screen 
(see  below). 
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Digitize  Menu 


Mouse  digi t izer 

|  AvOLNT  DIGITIZED 

I  #  Li  ne  s  :  0 

|  #  Area  edges :  0 

|  #  Si tes  0 

r  -----  .  .  - 

|  Total  points:  0 

Digitize  opti ons : 

|  CLPERsTT  DIGITIZER  FARMS. 

1 

<space>  Digi t  ize 
-  Togg  1  e  MODE 
t  -  Toggle  TYPE 

1  -  Auto  Label 
q  -  CXti  t  to  main  menu 

1 

1 

j  MIX-  TYPE 

|  >POINT<  1  i  ne 

j  stream  >AREA  EDGE< 

|  site 

1 

j  AntoLabel  :  DISABLED 

Edit  Label  Customize  Toolbox  Window  Help  Zoom  *  ! 

GLCBAL  1VENU:  Pres,  first  letter  of  desired  comnand.  [Upper  Case  Only] 


Use  of  the  in-jus*.  he  s?  general  principles  as  using  the  digitizing  cursor,  and  the  same  menu 

opti  is  apply.  The  r  t  exception  to  this  rule,  however,  is  that  the  mouse  can  only  be  used  to  digitize 
in  POINT  mode;  digitizing  in  STREAM  mode  is  not  allowed.  Hence,  as  shown  in  the  sample  screen 
above,  the  Toggle  MODE  option  in  the  Digitize  Menu  is  blank,  indicating  that  it  is  unavailable  for  use. 
The  examples  that  follow  use  a  three-button  mouse. 

When  digitiziu.  a  SITE  (using  type:  site),  the  following  instructions  appear: 


Site  digitizing 

Buttons: 

left: 

Digitize  a  site 

Middle: 

Abort/Quit 

Right: 

Ahort/Quit 

#  Points 

POINT  mode 

Easting  Northing 

As  each  site  locus  is  selected  by  pressing  the  left  button,  a  yellow  "X"  appears  on  the  graphics  screen, 
and  the  point’s  Fasting  and  Northing  ccxircli nates  appear  at  the  Ixittom  of  tlx-  screen.  The  following 
message  appears: 
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Do  you  accept  this  site? 

Buttons: 

Left:  yes 

Middle:  no 
Right:  yes 


#  Points  Easting  Northing 

1  490000.12  3440000.88 

NOTE:  1  new  nodes  needed 
POINT  mode 


Press  the  appropriate  mouse  button  to  respond. 

To  digitize  an  AREA  or  LINE,  the  following  set  of  instructioas  appears: 


Begin  digitizing? 

Buttons: 

Left:  yes 

Middle:  no 
Right:  yes 


And: 


Point  number  0 

Buttons: 

Left: 

Mark  a  point 

Middle:  (Bark  up  one  point) 

Right: 

Quit  digitizing 

#  Points 

Easting  Northing 

POINT  mode 

As  each  point  defining  the  linc/area  edge  is  selected,  its  sequence  number  and  UTM  ctx>rdi nates  are 
displayed;  the  line  segment  between  the  points  is  highlighted  in  yellow.  The  following  screen  shows 
that  four  points  have  been  digitized  to  define  a  line,  along  with  the  UiM  coordinates  of  the  last  point. 
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Poinl  number  4 
Buttons: 

Left:  Mark  a  point 

Middle:  (Back  up  one  pcrint) 
Right:  Quit  digitizing 


#  Pants  Easting  Northing 

4  505400.12  3440686.88 

POINT  mode 


K  a  point  does  not  appear  correct,  use  the  middle  key  to  delete  it;  press  the  middle  key  repeatedly  to 
delete  a  number  of  successive  points.  Upon  quitting,  the  next  message  appears: 


Do  you  accept  this  line? 

Buttons: 

Left:  yes 

Middle:  no 

Right:  yes 

#  Points  Easting 

Northing 

4  505400.12 

3440686.88 

NOTE:  [0,1^1  new  nodes  needed 

POINT  mode 

Press  the  appropriate  mouse  button;  continue  the  digitizing  procedure  as  needed.  Practice  digitizing 
with  each  of  the  possible  cursor  and  mouse  combinations  to  become  familiar  with  the  differences. 
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8.  THE  EDIT  MENU 

The  Edit  Mem  is  used  to  modify  vector  files  that  have  been  digitized  or  imported  from  other  sources. 
It  can  be  accessed  from  all  the  other  submenus.  The  following  screen  shows  the  layout  of  the  Edit 
Mem  with  the  default  parameters.  In  the  options  below,  die  word  "line"  is  used  generically  and  also 
refers  to  area  edges. 


GRASS -DIGIT  Version  4.0  Edit  Menu 


Edi t  opt  ions : 
r  -  Remove  line 
i  -  Remove  a  site 
s  -  Snap  line  to  node 
b  -  Break  a  line 
m  -  Mave  a  point 
M  -  Move  a  line  or  site 
t  -  Re-type  a  line  (AREA/LINE) 
d  -  Display  nodes  w/in  map  threshold 
R  -  Remove  BLOCK  of  lines 

q  -  Quit  to  main  menu 


Digitize  Label  Customize  Toolbox  Window  Help  Zoom  *  ! 

GLOBAL  MENU:  Press  first  letter  of  desired  conmand.  [Upper  Case  Only] 


8.1.  EDIT  MENU  OPTIONS 

Edit  uses  a  combination  of  keyboard  entries  ;uid  cursor  inputs  to  execute  command  functions.  Type  in 
the  first  letter  of  an  option  name  to  activate  it.  Interactive  instructions  appear  on  the  dumb  terminal 
screen  (or  the  shell  window  if  only  a  graphics  monitor  is  used).  The  MOUSE  is  used  in  all  editing 
operations.  Most  editing  procedures  follow  a  left-right-left-right  button  sequence  for  first  choosing,  and 
second,  accepting,  the  editing  function.  The  middle  button  is  used  to  abort  the  current  function.  All 
colors  described  below  are  tlie  DEFAULT  colors  for  the  particular  function  or  feature  (see  the 
Customize /Color  Menus).  The  features  being  edited  are  highlighted  in  yellow.  The  user  should  be  very 
careful  when  using  the  "remove"  functions  within  Edit',  if  accidentally  removed,  features  may  be  hard  to 
recover  or  reconstruct. 

r  -  Remove  Line 

Removes  a  previously  digitized  line.  Chmse  ;md  accept  the  line;  it  disappears  from  view  on  the 
graphics  screen.  This  option  repeats  automatically  for  as  many  features  as  the  user  requires. 

i  -  Remove  a  Site 

Removes  a  previously  digitized  site  location.  Choose  anil  accept  the  site;  it  will  disappear  from 
view  on  the  graphics  screen,  This  option  repeats  automatically  for  as  many  features  as  the  user 
requires. 

s  -  Snap  Line  to  Node 

Miuiual  procedure  to  "snap,"  or  join,  two  sep irate  ixxlcs  together  to  form  true  node,  hirst  choose 
a  line  and  nixie  to  snap  "from"  and  then  a  nixie  to  snap  "to."  This  option  will  repeat  automati¬ 
cally  for  as  many  features  as  tlie  user  requires.  Sec  the  expanded  explanation  below. 
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b  -  Break  a  Line 

Breaks  an  existing  line  segment  into  two  new  segments  and  inserts  a  node  at  the  designated  loca¬ 
tion.  First  choose  a  line  to  "break,"  and  then  a  "point"  on  the  line  to  break.  A  new  snapped 
node  will  appear  at  the  designated  locus.  This  option  repeats  automatically  for  as  many  features 
as  the  user  requires. 

m  •  Move  a  Point 

Used  to  reposition  a  point  in  a  line.  This  option  does  not  allow  the  movement  of  nodes  at  the 
end  of  line  segments,  only  the  points  within  a  line.  Choose  a  line  and  a  point  to  move,  and  a 
new  position  for  the  point.  The  point  moves  to  the  new  location  and  the  shape  of  the  line  is 
adjusted  accordingly.  The  user  may  wish  to  use  option  ”n  -  Show  Paints  in  Lines"  in  the  Win¬ 
dow  Mem  before  moving  the  pcsnt  (see  section  14). 

M  -  Move  a  Line  or  Site 

Used  to  reposition  a  line  or  site  to  a  new  location.  Unlike  "m"  above,  this  option  retains  the 
orientation  and  shape  of  the  original  feature,  but  simply  moves  the  whole  feature  to  a  new  posi¬ 
tion.  Choose  a  line/site  to  move,  and  a  new  location  for  the  line/site.  The  line/site  reappears  at 
the  new  location. 

d  -  Display  Nodes  w/in  Map  Threshold 

Displays  nodes  that  occur  within  the  given  distance  threshold  calculated  for  the  current  session. 
This  is  used  to  verify  if  nodes  from  different  lines  occur  close  enough  to  be  snapped  together, 
even  though  they  should  not  be.  This  is  important  if  nodes  will  be  automatically  snapped 
together  during  v.support.  The  user  is  allowed  to  make  the  map  threshold  larger  but  not  smaller. 
Type  the  new  threshold  value  after  the  prompt. 

t  -  Re-type  a  Line  (AREA/LINE) 

Changes  the  type  of  a  line  between  either  an  area  edge  or  a  line.  Use  the  mouse  to  point  at  the 
feature  to  be  changed.  Choose  and  accept  the  line;  the  color  of  the  feature  changes,  indicating 
that  its  topology  has  changed.  This  option  repeats  automatically  for  as  many  features  as  the  user 
requires. 

R  -  Remove  BLOCK  of  Lines 

Designates  a  group  of  lines  to  be  removed,  rather  than  having  to  delete  them  individually  using 
the  "r"  option  described  above.  Use  the  mouse  to  define  a  box  around  the  area  where  a  block  of 
lines  is  to  be  deleted.  Choose  and  accept  the  area.  The  program  asks  for  confirmation  before 
deleting  the  lines.  Only  the  lines  bounded  within  the  box  ;ire  removed.  Exercise  extreme  caution 
when  using  this  option. 

q  -  Quit  to  main  menu 

Returns  to  the  Main  Menu. 

8.2.  THE  EDITING  PROCEDURE 

(kie  of  the  most  frequently  used  procedures  in  the  Edit  Menu  is  that  of  snapping  adjacent  nodes 
together  to  join  line  segments.  It  is  also  the  most  complicated  function,  in  that  it  involves  more  than 
one  segment.  Ihe  user  should  be  wary  when  using  this  function  Ixxause  it  can  radically  alter  the  shape 
of  lines  if  the  nodes  to  be  snapped  together  are  too  far  apart  (refer  to  the  Customize  Menu  in  section  10 
for  a  description  of  the  "digitizing"  and  "snapping"  thresholds).  An  expanded  explanation  of  the  pro¬ 
cedure  is  presented  here.  It  should  provide  an  adequate  model  describing  the  other  editing  functions. 
Before  entering  the  edit  menu,  the  user  can  display  the  digitized  data  on  the  graphics  monitor  and 
search  for  possible  digitizing  errors. 

After  selecting  "s  -  Snap  Line  to  Node"  the  following  sequence-  appc;irs  [a  line  "X"  has  been  selected 
using  the  ;;jnusc  pointer]: 
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line  to  snap 

FROM: 

Buttons: 

Left: 

Choose  line 

Middle 

Abort/Quit 

Right: 

Accept  chosen  line 

Line#  X  Category:  (unlabeled) 

1)  The  selected  line  is  highlighted  in  yellow  and  the  next  query  appears  [where  node  "Y”  has  been 
selected] : 


Node  to  snap  TQ 
Buttons: 

Left:  Choose  node 

Middle:  Abort/Quit 
Right:  Accept  chosen  node 


node#  Y 

EAST:  [UTM  Easting) 
NORTH  [1/rM  Northing] 


2)  With  the  LEET  mouse  button,  select  the  node  to  which  you  want  the  line  snapped. 

3)  Ihc  selected  n<xlc  is  highlighted  in  yellow;  pressing  the  RIGHT  mouse  button  accepts  the  node  and 
causes  the  two  adjacent  nodes  to  lie  snajrped.  In  the  case  of  two  "open"  nodes  (green),  the  two  will  be 
joined  to  form  one  "closed"  node  (red).  Wlxre  a  line  is  being  snapped  to  an  existing  closed  node,  the 
sequence  is  THOM  the  line  TO  the  node.  It  is  not  possible  to  snap  existing  closed  tuxlcs  to  each  oilier. 
(See  ;ilso  the  discussion  of  digitizing  and  snapping  thresholds  in  the  Customize  Menu  in  section  10.1.) 
Al  so  lx:  aware  of  tire  following  warning  message  (answering  "no"  repeats  the  above  two  steps): 


Attempting  to  snap  a  line  to  itself.  Proceed?  [v] 


Especially  where  two  nixies  ;ire  close  together,  the  wrong  line  may  be-  inadvertently  chosen  to  "snap 
I  ROM";  if  the  ixxlc  is  sna|iped  then  the  line  may  actually  "double-back"  on  itself  and  the  original 
topilogy  may  lx  destroyed,  or  a  duplicate  line  or  sliver  may  be  created  which  can  cause  problems 
when  the  file  is  to  lx  convened  into  a  raster  layer.  If  the  user  mistakenly  destroys  original  topology, 
the  user  may  have  to  redigitize  the  modified  area.  In  the  case  of  a  self  closing  (xilygon  composed  of 
one  line  with  two  open  end|x>ints  (tuxlcs),  this  warning  message  can  lx  ignored,  Ixcause  tlx  polygon  is 
Ixing  closed  intentionally  on  itself. 
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9.  THE  LABEL  MENU 

Labelii^  is  the  process  of  assigning  category  values  to  digitized  features.  The  Label  Mem  can  be 
accessed  from  the  Main,  Digitize,  and  Edit  Menus  (described  in  sections  6, 7,  and  8).  The  screen  layout 
of  the  Label  Mem 1  with  default  option  settings  is  presented  below.  Colors  described  for  the  options 
are  the  defaults  (see  the  Customize  /Color  Menus,  described  in  sections  10  and  11),  which  the  user  may 
change. 
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Label  Menu 


Label  options: 
a  -  label  Areas 
1  -  label  Lines 
s  -  Label  Sites 

A  -  Un- label  Areas 
L  -  Un-Label  Lines 
S  -  Un- label  Sites 

B  -  Bulk  label  Remaining  Lines 

h  -  Highlight  Lines  of  category  # 
d  -  Display  Areas  of  category  # 

q  -  Return  to  main  menu 


m  -  Label  Miltiple  Lines 
M-  Un-Label  Multiple  Lines 


c  -  Label  Contours 
i  -  Contour  interval:  <  5> 


Digitize  Fxli  t  Customize  Toolbox  Wi  ndow  Help  Zocm  *  ! 

GLOBAL  MFNU:  1‘ress  first  letter  of  desired  corrmand.  [Upper  Case  Only] 


9.1.  LABEL  MENU  ( FIIONS: 
a  -  Label  Areas 

Assigns  a  category  value  to  an  area.  (See  the  expanded  explanation  in  section  0.2. ,  Labeling 
Prticedure.) 

I  -  Label  Lines 

Assigns  a  category  value  to  a  line.  First,  type  the  category  number  after  the  prompt.  Next,  move 
the  pointer  to  the  line  to  be  lalieled  (here,  unlabeled  lines  are  Hue).  Choose  and  accept  the  line. 
Ihe  line  King  Libeled  is  higlilighted  in  yellow,  and  when  accepted  turns  magenta.  No  lalvl 
value  appears  next  to  the  line  (enter  the  Customize  /I)  splav  Menu  to  change  the  display  option). 
Repeat  lalx  ling  lines  with  the  same  category  value  as  needed. 

s  -  Label  Sites 

Assigns  a  category  value  to  a  site.  First,  type  the  category  number  after  the  prompt.  Next,  nunc 
tlie  pointer  to  the  site  to  be  lalxled  (unlalx'lcd  sites  are  green).  Choose  the  site  yyith  the  left  but 
ton  and  accept  it  with  the  right.  Ihe  site  beire;  lalieled  is  highlighted  in  yelloyv  and  evhen 

1  Although  it  is  planned  ikit  future  releases  of  GRASS  issued  by  l  IS  At  I  Jt  I  .md  the  l  SPA  S(  N  will  be  identical, 
these  two  releases  m.n  oiler  somewhat  diffeient  functions  in  GRASS  4.0.  tin  functions  described  in  this  limm.il  arc 
those  of  the  t  NACI  RI  <  IKASS  4  0  release,  available  to  all  >  IRASS  users 
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accepted  turns  aqua.  No  label  value  appears  next  to  the  site  (see  the  Customize/Display  Menu  to 
change  the  display  option).  Repeat  labeling  sites  with  the  same  category  value  as  needed 

A  -  Un-Label  Areas 

Removes  a  category  value  from  an  area  or  group  of  areas.  Move  the  pointer  inside  the  area  to  be 
unlabeled.  Choose  and  accept  a  point  within  the  area.  Next,  move  the  pointer  to  a  boundaty  line 
for  the  area  and  choose  and  accept  the  line.  The  area  marker  and/or  label  inside  the  polygon 
disappears  and  the  color  of  the  selected  area  changes  from  orange  to  grey.  Repeat  as  necessary. 

L  -  Un-Label  Lines 

Removes  a  category  value  from  a  line  or  group  of  lines.  Move  the  pointer  to  the  line  to  be  unla¬ 
beled.  Choose  and  accept  the  line;  the  color  changes  from  magenta  to  blue.  Repeat  as  necessary. 

S  -  Un-I.abel  Sites 

Removes  a  category  value  from  a  site  or  group  of  sites.  Move  the  pointer  to  the  site  to  be  unla¬ 
beled.  Choose  and  accept  the  site;  the  color  for  the  site  ch;uiges  from  aqua  to  green.  Repeat  as 
necessary. 

B  •  Bulk  l.altel  Remaining  Lines 

labels  any  lines  which  remain  unlatielcd  (this  option  does  NOl'  apply  to  area  edge  lines).  Upon 
chixtsing  this  option,  the  user  is  asked  to  respond  to  the  following  prompt: 

|  Ibis  function  will  lalxl  I  VI  RY  tinlalielcd  line.  l*nxeed  (n| 


If  the  answer  is  yes,  enter  the  category  number  at  the  prompt.  As  the  program  proceeds  to  label, 
the  color  of  the  remaining  lines  elianges  from  blue  to  magenta  on  the  graphics  screen.  This 
option  is  convenient  for  labeling  a  large  number  of  line  features  having  the  same  category  value, 
such  as  roads  or  streams.  Be  cautious  when  executing  this  option,  however,  to  make  sure  that  all 
lines  have  lieen  labeled  properly,  'litis  option  does  NOl'  apply  to  labeling  area  edge  lines. 

h  -  Highlight  Lines  of  Category  ft 

Type  the  category  value  tiller  the  prompt.  ’Ihe  lines  with  the  specified  category  value  are 
highlighted  in  yellow. 

d  -  Display  Areas  of  Category  # 

Type  the  category  value  after  the  prompt.  Ihe  areas  with  the  specified  category  value  arc 
highlighted  in  yellow. 

m  -  l.altel  Multifile  Lines 

lalxls  line  segments  contiguous  to  each  other  (i.e.,  connected  liy  "snapped"  nixies).  Type  the 
category  number  .after  the  prompt.  Use  the  pointer  to  choose  a  line  to  label.  The  program 
highlights  (lie  connecting  lines  and  asks  the  user  if  these  are  correct.  Press  the  left  or  right  button 
to  answer  yes.  Ihe  highlighted  lines  will  change  color  to  magenta.  Ihis  option  is  convenient  for 
lalx'ling  a  huge  number  of  contiguous  line  features  of  the  same  category ,  such  as  roads  or  streams 
(sic  also  the  "Autolalxl"  function).  Be  cautitxis  when  executing  this  option  to  make  sure  that  all 
lines  have  Ixxrn  labeled  properly .  1  incs  that  arc  not  directly  connected  to  each  other  (i.e.,  have 
"o|x-n"  ixxles  between  them)  are  not  affected  by  this  option,  nor  ;irc  area  eilge  lines. 

M  -  IJn-Lnbil  Multiple  Lines 

Unlalx  ls  liix-  segnvnls  contiguous  to  each  other  (i.e.,  connected  by  "snapped"  nodes).  Use  the 
pointer  to  chixtsc  a  line  to  unlaUI.  Ihe  program  highlights  any  connecting  lines  and  asks  the 
user  to  confirm  these  lines.  Press  the  lelt  or  right  Ixitton  to  answer  yes.  All  the  lines  will  change 
color  to  blue.  Ik'  cautious  when  executing  this  option.  I1k'  jirogram  d( x's  NOr  differentiate 
Ixtwciii  different  cati-gon  \ allies  lor  tin-  contiguous  lines.  ALL  lines  will  lx:  unlabclcd,  whether 
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they  have  the  same  category  labels  or  not.  Lines  that  are  not  directly  connected  to  each  other 
(i  e.,  have  "open"  nodes  between  them)  are  not  affected  by  this  option,  nor  are  area  edge  lines. 

c  -  Label  Contours 

This  option  allows  the  rapid  labeling  of  contour  line  data,  such  as  that  imported  from  DXF  or 
DLG  format  files,  rather  than  having  to  label  each  interval  line  individually.  The  user  first  selects 
a  contour  interval.  (See  option  i  following.)  The  user  is  instructed  to  choose  and  accept  a  start¬ 
ing  line  and  an  associated  elevation  value.  Then  select  an  ending  line  and  associated  elevation 
value.  The  elevation  values  and  the  interval  must  correspond  exactly.  For  example,  if  there  are 
five  lines  to  be  labeled,  the  contour  interval  is  5,  and  the  first  line  has  a  value  of  250,  then  the 
fifth  line  must  have  a  value  of  270.  The  program  returns  an  error  message  if  the  contour  interval 
and  the  starting/ending  line  elevation  values  do  not  match. 

i  -  Contour  Interval:  <  5> 

Selects  an  interval  to  label  contour  lines  (see  the  previous  option,  c).  The  interval  can  be  any 
unit,  eg.,  1,  2,  4,  5,  10,  etc.  The  default  setting  is  5.  The  interval  specified  is  completely  arbi¬ 
trary,  or  in  the  case  of  imported  DXF  or  DIXj  files,  recorded  as  a  data  attribute.  The  user  should 
be  aware  of  the  original  map  data  and  how  it  was  extracted. 

q  •  Return  to  main  menu 

Return  to  the  Main  Menu  (see  section  6). 

9.2.  THE  LABELING  PROCEDURE 

The  Label  Menu  uses  a  combination  of  keyboard  entries  and  cursor  inputs  to  execute  functions.  Type 
the  first  letter  of  an  option  name  to  activate  it.  Interactive  instructions  appear  on  tlie  dumb  terminal 
screen  (or  the  shell  window  if  only  a  graphics  monitor  is  used).  The  mouse  is  then  used  to  select  the 
feature  to  be  modified,  labeling  operations  using  the  mouse  follow  a  left-right -left -right  lxilton 
sequence  for  first  choosing ,  tend  second,  accepting,  (i.e.,  verifying)  the  features.  The  middle  button  is 
used  to  quit  the  current  function.  The  "label"  and  "unlabcl"  functions  are  somewhat  redundant.  For 
example,  it  is  not  necessary  to  "unlabel"  a  feature  before  giving  it  a  new  label;  it  is  possible  to  rclalxT  a 
feature  directly  by  using  the  lalxd  option  and  simply  assigning  a  new  category'  value.  The  old  lalxT  is 
overwritten  by  the  new  one. 

Before  beginning  to  label,  identify  each  possible  feature  on  the  original  map  and  the  lalxT  value  that 
will  be  assigned  to  it.  Most  analysts  have  their  own  mnemonic  procedure  for  labeling.  For  features 
having  no  numerical  values  associated  with  them  (such  as  soil  types,  streams,  etc.)  it  is  suggested  to 
label  the  features  sequentially,  Ixgiiming  with  category  v;ilue  1  turd  continuing  as  needed.  For  those 
features  already  possessing  a  known  numerical  value  (such  as  a  contour  line,  firing  point,  etc.)  the 
analyst  may  want  to  retain  the  original  designation. 

IMPORTANT:  labels  can  only  lx-  positive  or  negative  integers;  no  alpha  characters  or  decimal  jioints 
are  acceptable.  The  value  zero,  0,  is  reserved  for  tlx1  category  no  data.  No  feature  may  be  lalxTed 
with  a  zero.  Zero  is  also  used  to  exit  exit  of  the  lulx'ling  function  (sec  below). 

The  labeling  procedure  is  similar  tor  areas,  lines,  and  sites.  Since  the  lalxTing  o!  ;ireas  is  the  most 
complicated,  however,  it  is  dcscrilxid  in  more  detail  here.  This  should  serve  as  an  adequate  model 
inscribing  the  other  labeling  functions. 

After  selecting  "a  -  LalnT  Area."  the  following  sequence  apixars: 


-35- 


Enter  Category  Number  (0  to  END):[0] 


Type  in  the  category  number  for  the  area,  and  <RETURN>.  The  next  message  appears: 


Select  point  within  area: 

Buttons: 

Left:  Choose  this  position 

Middle:  Abort/Quit 

Right:  Accept  chosen  point  position 

Point  location: 

East:  [UTM  Eastirg] 

North:  [UTM  Northing] 


On  the  graphics  screen,  position  the  pointer  within  the  chosen  area,  usually  somewhere  near  the  middle 
of  the  feature,  and  press  the  LEFT  button.  A  yellow  dot  appears  at  the  designated  locus,  and  the  UTM 
coordinates  of  the  point  are  displayed  on  the  menu  screen.  If  this  position  is  not  suitable,  simply  move 
the  pointer  ;ind  chtxise  a  new  spot.  Once  the  position  is  satisfactory,  press  the  RIGHT  button  to  accept 
it;  the  color  of  the  dot  chaises  to  orange  (this  is  the  AREA  MARKER).  The  next  message  appears: 


Select  a  Boundary  line: 

Buttons: 

Left:  Choose  line 

Middle:  Abort/Quit 
Right:  Accept  chosen  line 


Position  the  pointer  on  a  bound: try  line  defining  the  area  and  press  the  LEFT  button;  the  chosen  line  is 
highlighted  in  yellow.  The  following  message  appears  on  the  bottom  of  the  menu  screen: 


Area  is  not  labeled 


[OR]  if  the  ;trea  has  been  previously  labeled: 


Area  is  labeled  category  X 
[Where  "X'  is  some  integer] 
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If  die  highlighted  line  is  correct,  then  accept  it  with  the  RIGHT  button.  All  the  other  lines  defining  the 
selected  area  are  highlighted  in  yellow.  Some  problems  can  occur  at  this  stage  of  the  piocess-if  there 
are  any  open  nodes  around  the  perimeter  of  the  area,  or  slivers  or  overshoots,  the  program  responds 
with  a  BEEP  and  die  following  warning  message  appears: 


Could  not  create  area 


This  message  disappears  quickly,  and  the  program  reverts  to  the  point  selection  screen.  The  analyst  has 
to  determine  the  cause  of  the  error  message  and  may  have  to  perform  additional  editing  and/or  digitiz¬ 
ing.  The  Toolbox,  Window,  and  Debug  Menus  can  also  be  consulted  for  further  assistance  (see  sections 
13, 14,  and  16).  Provided  no  errors  occur,  however,  the  next  message  appears: 


Accept  this  area? 

Buttons: 

Left:  yes 

Middle:  no 
Right:  yes 

Area  is  Category  X 


If  the  iirea  appears  satisfactory,  press  either  the  LEFT  or  RIGHT  button;  the  color  of  the  boundary  line 
changes  to  orange  and  the  category  label  appears  to  the  upper  right  of  the  area  marker.  Alter  accepting 
the  area,  the  program  returns  to  the  point  selection  screen.  If  continuing  to  label  other  areas  with  the 
same  category  label,  simply  repeat  the  process.  To  change  category'  values,  press  the  MIDDLE  button 
to  quit,  type  in  the  new  number,  and  proceed.  To  end  the  labeling  process  altogether,  type  in  zero  [0] 
and  <REIURN>  at  this  juncture.  In  the  display  default  settings,  note  that  if  the  graphic  screen  is 
redisplayed  or  the  Customize  /Display  Menu  options  are  modified,  then  the  category  labels  disappear, 
leaving  only  the  area  markers,  and  the  area  edges  turn  color  back  to  grey . 
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10.  THE  CUSTOMIZE  MENU 

This  menu  contains  options  to  modify  certain  input  and  display  parameters  during  a  digitizing  session. 
The  screen  layout  of  the  Customize  Menu  and  tire  default  settings  are  presented  below.  This  menu  can 
be  accessed  from  the  Main,  Digitize,  Edit  and  Label  Menus. 
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Customize  Menu 

Customize  options: 

Current : 

d  -  Set  digitizing  threshold 

0.0300 

s  -  Set  snapping  threshold 

0.0300 

b  -  Toggle  BEEP 

CN 

a  -  Toggle  Auto  Window 

OFF 

w  -  Togg  1  e  Wi  ndowi ng  device 

DIGITIZER 

p  -  Toggle  Point  device 

MUSE 

d  -  Toggle  Digitizing  device 

DIGITIZER 

O  -  Select  An  Overlay  Mip 

None 

B  -  Select  a  Backdrop  CELL  Map 

None 

-  Select  a  Label  Mtp 

D  -  Enter  Display  Options  Menu 

C  -  ELnter  Color  Options  Menu 

q  -  Return  from  whence  we  came 

Help  Zoom  *  ! 

GLCRAL  MENU:  Press  first  letter  of 

desired  comnand.  [Upper  Case  Only] 

10.1.  CUST  OMIZE  MENU  OPTIONS 

All  options  in  the  Customize  Menu  are  selected  front  the  KEYBOARD  by  pressing  the  key  correspond¬ 
ing  to  the  first  letter  of  the  command.  The  Custonize  Menu  options  set  within  a  digitizing  session  do 
not  carry  over  into  the  next  session.  In  the  descriptions  below,  the  DEFAULT  settings  are  presented 
first,  followed  by  the  alternate. 

d  -  Set  Digitizing  Threshed 

Sets  the  amount  of  space  to  be  left  between  jxiints  collected  by  the  digitizer.  To  change  the  digi¬ 
tizing  threshold,  press  "d"  and  the  following  message  appears  in  the  global  field.  Enter  the  new 
threshold  value  at  the  prompt.  Upon  exiting,  the  new  value  appears  under  the  "Current"  heading. 
(Ruiz  and  Messersmith,  1990  gives  a  more  detailed  discussion.) 


Current  thresholds: 

Map  :  38.100000  meters. 

Dig  :  0.030000  -  1  /  33333333  of  an  inch. 

Enter  new  Dig  threshold  or  <R1  TURN > when  finished: 


s  -  Set  Snapping  Threshold 

Sets  a  threshold  value  definin'  the  amount  of  space  less  than  which  two  adjacent  nodes  automati¬ 
cally  will  lie  "snap|x\l,"  or  joined  together,  to  make  one  node.  For  example,  if  the  snapping 
threshold  were  set  at  0.03  (digitizer)  in.,  rxxtcs  placed  less  than  0.03  in.  apart  (on  the  digitizing 
tablet)  would  lie  snapped  together  into  a  single  node,  while  nodes  placed  more  th;ui  or  equal  to 
0.03  in.  apart  would  lie  left  alone.  The  digitizing  threshold  and  the  snapping  thrcslxild  do  not 
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necessarily  have  to  be  the  same  for  any  particular  scale  map,  but  the  default  values  usually  are  set 
the  same.  The  threshold  values  chosen  depend  on  the  accuracy,  resolution,  and  level  of  detail 
desired  in  the  final  digital  map  (Ruiz  and  Messersmith,  1990  gives  a  more  detailed  discussion). 
The  format  for  choosing  a  new  snapping  threshold  follows  that  of  the  digitizing  threshold 
described  above. 

b  -  Toggle  BEEP 

Selects  whether  an  audio  signal  is  to  be  emitted  from  the  terminal  during  the  digitizing  session. 
Mary  functions  in  v .digit  use  a  BEEP  to  indicate  their  activation.  It  is  recommended  to  keep  the 
beep  "CM"  to  determine  when  certain  cursor  functions  have  been  selected,  eg.,  snapping  nodes, 
editing,  etc. 

a  -  Toggle  Auto  Window 

Adjusts  the  working  window  to  automatically  encompass  more  of  an  area  feature  being  labeled  if 
most  of  the  area  initially  falls  outside  the  original  dimensions  of  the  window.  This  option  is  used 
for  labeling  areas  only  (see  also  section  9,  Label  Menu). 

w  -  Toggle  Windowing  Device 

Selects  whether  the  DIGITIZER  cursor  or  the  MOUSE  is  used  as  the  windowing  device.  Once 
the  working  window  has  been  initially  selected  using  the  digitizing  cursor  (see  Entering  the  Digi¬ 
tizing  Session),  it  may  be  more  convenient  to  use  the  mouse  to  choose  subsequent  windows  (see 
section  15,  The  Zoom  Menu).  If  no  digitizer  is  selected  when  entering  the  session,  then  only  the 
mouse  is  available  for  use. 

P  '  Toggle  Point  Device 

Selects  whether  the  MOUSE  or  the  DIGITIZER  cursor  is  used  as  the  pointing  device.  In  most 
instances,  it  is  more  convenient  to  use  the  mouse.  If  no  digitizer  is  selected  when  entering  the 
session,  then  only  the  mouse  is  available  for  use  in  this  option. 

d  -  Toggle  Digitizing  Device 

Selects  whether  the  DIGITIZER  cursor  or  the  MOUSE  is  used  as  the  digitizing  device.  The 
digitizer  cursor  is  normally  used  for  the  initial  input  of  vector  data.  However,  for  modifying  the 
data  once  they  have  been  entered,  it  may  be  more  convenient  to  use  the  mouse.  If  no  digitizer  is 
selected  when  entering  the  session,  then  only  the  mouse  is  available  for  use  in  this  option. 

O  -  Select  an  Overlay  Map 

Displays  a  background  vector  layer  for  visual  comparison  and  reference.  To  display  a  vector 
overlay,  type  "O";  the  following  prompt  appears  at  the  bottom  of  the  menu  screen: 


Tnter  the  name  of  an  existing  vector  file 
Enter  ’list’  for  a  list  of  existing  vector  files 
I  fit  RETURN  to  cancel  request 

> 


After  choosing  the  vector  file,  the  following  query  appears: 


Do  you  want  to  automatically  redraw  backdrop  on  re- window?  (y/n)  [y] 
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After  responumg,  this  message  appears  in  the  global  field: 


.  Press  <£SC>key  to  stop 


Plotting  overt  ay  Map 


More  than  one  overlay  vector  layer  can  be  displayed  (although  the  result  might  be  confusing).  If 
the  automatic  redraw  option  is  not  selected  and  the  working  window  is  changed,  all  the  overlay 
vectors  will  have  to  be  reselected.  The  order  in  which  vector  overlays  are  selected  is  important. 
The  second  vector  overlay  supersedes  the  first.  Only  one  overlay  vector  can  be  automatically 
redrawn.  If  the  working  window  is  changed,  the  last  vector  overlay  selected  for  automatic  redraw 
is  the  only  one  that  will  be  redisplayed  in  the  new  window. 

B  -  Select  a  Backdrop  CELL  Map 

Displays  a  background  raster  (cell)  layer  under  the  current  vector  file.  The  background  map  is 
often  useful  for  providing  a  frame  of  reference  while  digitizing  and  to  check  how  the  layers 
match  each  other.  Only  one  backdrop  raster  map  can  be  displayed  at  a  time.  The  sequence  for 
choosing  the  raster  map  is  the  same  as  for  choosing  the  vector  overlay  map  previously  described. 
One  note  of  caution:  the  color  table  for  the  raster  layer  may  obscure  the  vector  overlay  map  if 
the  overlay  color  is  not  chained  (see  section  11,  Color  Menu,  to  change  the  default  color 
options). 

L  -  Select  a  Label  Map 

This  option  is  not  available  at  this  time,  but  may  be  included  in  future  GRASS  releases. 

D  -  Enter  Display  Options  Menu 

Accesses  the  Display  Menu  to  change  the  display  parameters  of  features  appearing  on  the  graphic 
screen  (entry  is  possible  only  through  this  menu). 

C  -  Enter  Color  Options  Menu 

Accesses  the  Color  Menu  to  change  the  color  parameters  of  features  appearing  on  the  graphic 
screen  (entry  is  possible  only  through  this  menu). 

q  -  Return  from  whence  we  came 
Returns  to  the  previous  menu. 
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11.  THE  COLOR  MENU 

Features  in  v.digit  are  color  coded  for  ease  of  identification.  The  screen  layout  of  the  Color  Menu  is 
presented  below.  The  colors  are  the  default  settings  of  the  features  as  they  appear  on  the  graphic  screen. 
The  Color  Menu  can  only  be  accessed  through  the  Customize  Menu  (see  section  10). 
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Color  Menu 


Color  options:  Current: 

a  -  Areas  grey 

1  -  Lines  blue 

s  -  Sites  green 

A  -  Labeled  areas  orange 

L  -  Labeled  lines  magenta 

S  -  Labeled  sites  aqua 

1  -  Nodes  w/  1  line  green 

2  -  Nodes  w/  2  or  more  lines  red 

h  -  Highlight  yellow 

B  -  Background  black 

O  -  Overlay  map  white 

r  -  Reset  Defaults 


q  -  Return  from  whence  we  came 


ffeip  Zoom  *  ! 

GLOBAL  MENU:  Press  first  letter  of  desired  conmand.  [Upper  Case  Only] 


11.1.  COLOR  MENU  OPTIONS 

Colors  are  changed  by  toggling  the  appropriate  key  for  the  feature  to  be  changed  (eg.,  press  a  to 
change  the  color  for  areas).  There  are  twelve  colors  that  can  be  selected;  they  toggle  in  the  following 
sequence:  grey,  magenta,  aqua,  indigo,  violet,  white,  black,  yellow,  blue,  red,  green,  orange.  The  first 
six  options  a  through  S  are  self-explanatory. 

The  remaining  options  are  described  below.  Once  new  options  are  selected,  the  graphic  screen 
automatically  refreshes  to  show  the  changes. 

1  -  Nodes  w/  1  line 

Nodes  that  form  the  endpoints  of  unattached  line  segments  are  open  or  "loisnapped'  (here  "line" 
is  used  in  the  generic  sense,  including  also  area  edge  lines).  They  are  color- axled  green. 

2  -  Nodes  w/  2  or  more  lines 

Nodes  at  the  intersection  of  two  or  more  line  segments  (including  area  edge  lines)  should  lx: 
closed  or  "snapped."  They  are  color-axled  red. 

v.digit  distinguishes  between  nodes  which  represent  "open"  and  "closed"  lines.  The  distinction  between 
"opai"  ;ind  "closed"  nodes  is  important  if  the  vector  layer  represents  area  features  to  be  converted  into 
a  raster  layer.  The  creation  of  a  raster  area  polygon  is  not  allowed  if  the  lines  comprising  the  polygon 
arc  not  properly  connected,  or  closed.  The  creation  of  raster  layers  from  sites  or  line  segments  is  not 
affected  by  the  | presence  of  open  nodes. 
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h  -  Highlight 

Many  functions  in  v .digit  make  use  of  highlighting.  The  default  highlight  color  is  yellow. 

B  -  Background 

Changes  the  background  color  field  on  which  the  vector  lines  are  displayed.  The  default  color  is 
black. 

O  -  Overlay  Map 

Selects  the  cola-  of  any  vector  files  to  be  displayed  as  overlay  references  to  the  layer  currently 
being  digitized.  See  also  the  Customize  Menu  described  in  section  10. 

r  -  Reset  Defaults 

Resets  the  default  colors  back  to  their  original  values  if  changed  by  the  user  during  a  digitizing 
session.  Upon  exiting  a  session,  the  color  options  are  automatically  reset  tc  the  default  values. 
Any  alternate  color  options  must  be  specified  again  by  the  user  on  reentering  ti  '  unitizing  ses¬ 
sion. 

q  -  Return  from  whence  we  came 

Returns  to  the  Customize  Menu. 
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12.  THE  DISPLAY  MENU 

This  menu  contains  options  to  change  the  display  parameters  for  features  appearing  on  the  graphics 
screen  Airing  the  Agitizing  session.  The  screen  layout  of  the  Display  Menu  showing  default  parameters 
is  presented  below.  This  menu  can  only  be  accessed  through  the  Customize  Menu  described  in  section 
10. 


1  . -  . . -  - 

(HASS-DIGIT  Version  4.0 

Di  spl ay  Menu 

Display  options: 

Current : 

a  -  Area  Label s 

or 

1  -  Line  Label s 

OFF 

s  -  Site  Label s 

OT 

m  -  Area  Markers 

CN 

A  -  Area  Border  lines 

OFF 

L  -  Labeled  1  ines 

CN 

i  -  Lines 

CN 

S  -  Sites 

CN 

n  -  Nodes 

CN 

p  -  Points  in  lines 

r  -  Reset  Defaults 

OFF 

q  -  Return  from  whence  we  came 

Help  Zoom  *  ! 

GLOBAL  MENU :  Press  first  letter  of 

desired  conmand. 

[Upper  Case  Only] 

12.1.  DISPLAY  MENU  OPTIONS 

Display  options  can  be  toggled  between  ON  (they  appear  on  the  graphics  screen)  and  OFF  (they  do  not 
appear).  Options  set  during  a  Agitizing  session  do  not  carry  over  to  the  next;  they  are  automatically 
reset  to  the  default  values.  Refer  to  the  Color  Menu  described  in  section  11  for  the  color  coding  of  the 
Display  Menu  options.  0)1  ors  mentioned  below  are  the  default  colors.  In  the  following  descriptions, 
the  default  setting  is  described  lirst,  followed  by  the  alternate. 

a  -  Area  Labels 

This  option  is  normally  OFF  to  prevent  cluttering  of  the  screen  when  many  features  are  being 
Asplayed.  When  turned  ON,  the  category  values  assigned  to  labeled  areas  are  Asplayed  within 
the  polygons  (see  the  label  Menu  in  section  9).  lire  latter  setting  is  recommended  when  Agitiz¬ 
ing,  labeling,  and/or  editing  areas. 

I  -  Line  Labels 

This  option  is  normally  OFF  to  prevent  cluttering  of  the  screen  when  many  features  are  txting 
displayed.  When  turned  ON.  the  category  values  assigned  to  labeled  lines  are  Asplayed  near  the 
midpoint  of  the  lines  (see  the  label  Menu  in  section  9).  The  latter  setting  is  recommended  when 
Agitizing,  lalx-ling,  and/or  editing  lines. 
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s  -  Site  Labels 

This  option  is  normally  OFF  to  prevent  cluttering  of  the  screen  what  many  features  are  being 
displayed.  When  turned  ON,  the  category  values  assigned  to  labeled  sites  are  displayed  to  the 
upper  right  of  the  sites  (see  the  Label  Menu  in  section  9).  The  latter  setting  is  recommended 
when  digitizing,  labeling,  and/or  editing  sites. 

m  -  Area  Markers 

Displays  the  area  marker  of  a  labeled  area,  as  represented  by  a  point  (default  color  orange).  The 
marker  is  the  actual  point  location  in  (x,y)  space  within  the  polygon  where  a  category  label  has 
been  placed  (see  the  Label  Menu  in  section  9).  This  point  is  used  here  only  as  a  visual  reference, 
but  does  have  meaning  with  regard  to  feature  topology  (i.e.,  raster  areas  cannot  be  created 
without  it).  Ihe  user  may  wish  to  toggle  the  display  of  Area  Markers  OFF  if  the  user  is  adding 
feature  labels  to  a  map.  to  prevent  the  display  screen  from  becoming  confusingly  cluttered. 

A  -  Area  Border  Lines 

In  the  OFF  setting,  area  edges  are  displayed  in  grey,  whether  the  areas  are  labeled  or  not.  If 
turned  ON,  the  lines  that  make  up  labeled  areas  arc  displayed  in  orange.  It  is  recommended  to 
use  the  latter  setting  when  digitizing,  labeling,  and  editing  areas. 

L  -  Labeled  Lines 

Displays  labeled  lines  in  magenta  and  unlabeled  lines  in  blue.  If  turned  OFF,  all  lines  will 
display  in  blue  (not  recommended).  Area  edge  lines  are  unaffected;  they  remain  white  in  color. 

i -  Lines 

Displays  tmlalxtled  lines  in  blue,  labeled  lines  in  magenta,  and  area  eilges  in  grey.  If  turned 
OFF,  only  lalx'lcd  lines  appear  (magenta)  and  lines  defining  area  edges  and  unlabeled  lines  do 
not  appear  at  till  (not  recommended). 

S  -  Sites 

Displays  lalx’led  sites  in  aqua,  and  unlabcled  sites  in  green.  If  turned  OFF,  sites  will  lie 
represented  simply  by  a  red  (closed)  nixie.  Tlte  latter  option  is  NOT  recommended  in  order  to 
avoid  confusion  with  nixies  on  line  segments  and  spuriixis  "floating"  nixies. 

n  -  Nodes 

Displays  nixies  as  points.  "Open"  or  "unsnapped"  nixies  are  displayed  in  green,  while  "dosed"  or 
"snap|X’d"  nixies  are  displayed  in  red.  If  turned  OFF.  nixies  will  not  appear  (not  recommended). 

p  -  Points  in  Lines 

'Ihis  option  is  unmially  OFF  to  avoid  possible  confusion  with  nixies.  If  turned  ON,  all  the  points 
that  descrilx*  a  line  are  displayed,  not  just  the  nixies.  Ilie  |xiints  are  displayed  the  same  color  as 
the  nixies  tiny  might  represent,  that  is,  red  for  a  "snapped"  or  "dosed”  line  segment,  and  green 
for  "unsnap|x'd"  or  "open”  lines.  If  a  line  is  composed  of  a  mixture  of  snapivd  and  unsnapixxl 
segments,  then  they  are  visually  represented  as  unsnapped  (i.e.,  the  jx'ints  will  appettr  green). 
Ihe  ON  setting  is  sometimes  useful  when  breaking  or  snapping  lines  during  editing  (see  tlx-  hill 
Menu,  descrilx'd  in  section  N). 

r  -  Reset  Defaults 

Resets  all  options  to  the  default  values. 

<(  -  Return  from  w  hence  we  came 

Returns  to  the  <  itMonuze  Menu  and  relreslies  the  di splat  screen  if  am  parameters  have  Ixen 
changed. 
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13.  THE  TOOLBOX  MENU 

This  menu  provides  a  number  of  utilities  that  help  to  find  and  diagnose  problems  that  can  occur  while 
digitizing.  In  the  following  descriptions,  the  default  highlight  color  for  all  options  is  yellow.  The 
Toolbox  Mem  can  be  accessed  from  the  Main,  Digitize,  Edit,  and  Label  Menus. 


GRASS-DIGIT  Version  4.0  Toolbox  Menu 


Toolbox  options: 
w  -  Write  out  session 
R  -  Regi s  ter  map 
B  -  Build  Neat  Li  ne 

u  -  Display  Unlabeled  Areas 
o  -  Display  Open  area  lines 
d  -  Display  Duplicate  lines 

n  -  Display  Node  lines 
i  -  Di  splay  Islands 

q  -  return  from  whence  we  came 


Wi  ndow  He  1  p  Zoom  *  ! 

GLOBAL  IVENU:  Press  first  letter  of  desired  command.  [Upper  Case  Only] 


13.1.  TOOLBOX  MENU  OPTIONS 
w  -  Write  out  session 

Saves  the  results  of  work  completed  during  the  current  digitizing  session.  If  the  session  lasts  for 
a  long  time,  this  option  shall d  be  used  periodically  to  prevent  loss  of  data  due  to  an  inadvertent 
power  loss,  system  shutdown,  or  other  interruption. 

R  -  Register  map 

Allows  the  user  to  register  and  re-register  one  or  more  maps  to  the  digitizing  board  without  hav- 
ing  to  exit  and  re-enter  v.digit.  This  is  useful  if  the  digitized  map  layer  is  composed  of  multiple 
map  sheets  (e.g.,  adjacent  USGS  quad  sheets)  as  is  often  the  case  with  huge  installations  or  geo¬ 
graphic  areas.  The  procedure  is  the  same  as  when  first  registering  a  map  (see  Entering  v.digit). 
If  no  digitizer  is  selected  upon  first  entering  the  v.digit  program,  this  option  will  not  lx  available 
to  the  user.  (It  will  show  up  .as  a  "blank"  space  before  the  option  description.) 

It  -  Build  Neat  Line 

When  the  points  used  to  register  a  map  fonn  a  rectangle  (such  as  using  four  U1TVI  grid  intersec¬ 
tions).  this  option  can  lx  used  to  fonn  lines  connecting  these  fair  |x>ints.  The  lines  create  a  box. 
or  "neat  line"  around  the  area  defined  by  these  lines  and  acts  as  a  straight  baindary  that  other 
lines  can  join.  It  also  serves  a  visual  purpose  to  highlight  or  emphasize  a  particular  area  of 
interest.  If  no  digitizer  is  selected  upon  first  entering  the  v.digit  prognun,  this  option  will  not  lx 
available  to  the  user.  (It  will  show  up  as  a  "blank"  space  Ix-fore  the  option  description.) 
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u  ■  Display  Unlabeled  Areas 

Highlights,  in  yellow,  those  polygons  that  have  not  been  labeled.  The  option  works  properly  only 
after  running  the  GRASS  programs  v .support  or  v .import.  This  is  because  the  v .digit  program 
cannot  recognize  the  polygons  until  their  spatial  topology  is  built  by  v -support.  For  complex 
features,  it  may  be  helpful  to  first  use  the  "Clear  Window"  function  in  the  Window  Menu  (see 
section  14)  before  choosing  this  option. 

o  -  Display  Open  Area  Lines 

Finds  areas  that  cannot  be  properly  labeled  because  there  are  one  or  more  unsnapped  nodes  that 
prevent  the  polygons  from  closing.  Edge  lines  that  bound  unlabeled  areas  are  highlighted  in  yel¬ 
low.  It  is  recommended  that  this  function  be  used  only  after  labeling  all  areas  and  executing  the 
GRASS  pregram  v.support. 

d  -  Display  Duplicate  Lines 

Highlights  lines  which  have  been  accidentally  double-digitized.  See  also  "n  -  Display  Node 
Lines"  below. 

n  -  Display  Node  Lines 

Highlights  the  lines  attached  to  a  particular  node.  This  function  is  useful  for  fixing  two  common 
digitizing  problems:  overshoots  and  double-digitizing  the  same  line.  Areas  are  built  in  v.digit  by 
following  the  angles  of  lines  that  attach  to  nodes;  therefore,  overshoots  cause  bad  angle  informa¬ 
tion  to  lie  stored.  This  and  double  digitization  can  also  cause  slivers  of  bad  data  to  be  created 
(sec  section  13.2,  Finding  Errant  Nodes). 

i  -  Display  Islands 

Ifighlights  islands,  or  area  polygons  completely  embedded  or  enclosed  witliin  other  polygons. 
'Uiis  option  is  useful  for  locating  lakes,  soil  types,  mid  other  features  that  may  occur  witliin  other 
features. 

<1  -  Return  from  Whence  We  Came 

Returns  to  the  menu  used  prior  to  the  Toolbox  Menu. 

13.2.  f  inding  Errant  Nodes 

It  is  sometimes  difficult  to  locale  a  problem  nixie  when  the  prognun  complains  that  it  cannot  label  or 
IxiilcI  an  area.  Often  the  user  has  to  examine  each  nixie  intersection  tliat  composes  ;ui  area  polygon.  At 
this  juncture,  it  may  lx:  useful  to  enter  the  Debug  Menu  (sec  section  16,  and  the  following )  to  lixate  the 
nixies  in  question.  It  is  suggested  to  zoom  as  closely  as  possible  around  the  suspected  inxle(s)  lxvause 
some  slners  and  line  overshixits  can  lx-  quite  small  (see  the  Zoom  Menu,  described  in  section  15).  At 
this  time,  it  is  also  recommended  to  enter  tlx;  Window  Menu  (see  section  14)  and  choose  the  "C  -  Clear 
Window"  option  to  erase  the  graphics  screen.  Ilxai  chixxsc  option  "n  -  Show  Nixies"  to  redisplay  the 
suspected  nixies  (see  section  14.  The  Window  Menu).  Sometimes  at  this  point,  "open"  nixies  that  were 
previixtsly  obscured  by  other  nixies  lx'come  apptirent.  lliesc  errant  nixies  may  lx-  tlx-  cause  of  the 
problem  and  can  either  lx:  removed  or  snapped  using  the  i'xiit  Menu  (see  section  8).  Ilicn  reenter  the 
TooIbo.\  Menu  and  choose  option  "n  -  Display  Nixie  Lines."  llie  mouse  is  used  to  select  and  accept  the 
nixie.  1’ress  the  RIGID'  mouse  button  to  view  lines  cixmtcr-clockwise  arixind  the  nixie,  and  the  I.I.IT 
button  to  view  them  clixkwise.  Each  line  is  highlighted  sequentially  around  the  nixie  while  a  descrip 
lion  of  its  to|X)logy  is  display  ed  at  the  Ixittom  of  the  screen.  (Xershixits  are  indicated  when  the  visible 
lines  exteniling  from  a  given  nixie  fail  to  lx-  highlighted  in  the  proper  sequence  around  the  nixie 
Double  digitized  lines  are  indicated  if  a  line  is  highlighted  twice  in  a  row.  For  a  more  detailed  descrip 
tion  of  this  prix'ess,  consult  the  Debug  Menu  (see  section  16). 
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14.  THE  WINDOW  MENU 

This  menu  provides  options  to  modify  the  graphic  screen  parameters  to  check  the  accuracy  and  com¬ 
pleteness  of  digitized  features.  This  menu  can  be  accessed  through  the  Main,  Digitize,  Edit,  Label,  and 
Toolbox  Menus.  The  screen  layout  of  the  Window  Menu  is  presented  below. 


GRASS-DIGIT  Version  4.0 


Wi ndow  opt i ons : 
a  -  Show  area  markers 
A  -  Show  area  labels 

i  -  Show  1 i ne  s 
1  -  Show  labeled  lines 
L  -  Show  line  1 abe 1 s 

s  -  Show  sites 
S  -  Show  site  1 abe 1 s 
n  -  Show  nodes 

q  -  Return  frail  whence  we  came 


Wi  ndow  Menu 


W  -  Define  new  window 
C  -  Cl  ear  wi ndow 

c  -  Di  spl ay  scale 
w  -  Where  am  I 
O  -  Display  Overlay  Map 
B  -  Display  Backdrop  CELL  Map 


He  1  p  Zoan  *  ! 

GLOBAL  MENU:  Press  first  letter  of  desired  c amend.  [Upper  Case  Only] 


14.1.  WINDOW  MENU  OPTIONS 

Many  of  the  options  in  the  Window  Menu  are  redundant  with  those  in  the  Label  or  toolbox  Menus. 
However,  the  Window  Menu  is  more  often  used  for  quick  reference  than  for  the  actual  modification  of 
features.  The  options  "a  -  Show  Area  Markers"  through  "S  -  Show  Site  Labels"  should  lie  familiar  to 
the  user  from  their  use  in  other  menus,  the  following  options  require  some  further  explanation,  how¬ 
ever.  All  colors  described  below’  arc  the  DEFAULT  colors  for  the  particular  function  or  feature.  See¬ 
the  Customize  Menu  to  cliangc  the  default  color  and  display  options. 

n  -  Show  nodes 

Displays  the  tuxlcs  (line  endpoints),  whether  closed  (red)  or  open  (green).  Ibis  option  is  useful 
for  locating  problem  nodes  when  trying  to  label  or  create  area  polygons  (sec  also  the  I ulxi.  Tool¬ 
box,  and  Debug  Menus). 

W  -  Define  new  window 

Starts  an  interactive  pnxedure  to  define  a  new  digitizing  window  .  The  options  are  to  zoom 
in/z<x)iii  (Hit  or  pan  (same  as  the  Zoom  Menu).  Use  either  the  iiuxisc  or  the  digitizer  cursor  to 
define  a  window. 

c  -  Display  scale 

Displays  a  bar  scale  in  the  upper-left  conx-r  of  the  current  digitizing  window,  lhe  scale  is  metric 
(kilometers  or  meters,  depending  on  the  size  of  the  window). 
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C  -  Clear  window 

Erases  the  contents  ctf  the  graphics  window  on  the  monitor  screen.  Use  this  option  before 
displaying  the  features  to  be  examined  (see  options  "a"  through  "n"  above).  This  option  is  useful 
for  locating  "unsnapped"  nodes,  errant  lines,  unlabeled  areas,  etc.,  (also  see  the  Toolbox  Menu). 

w  -  Where  Am  I 

Activates  the  pointing  device  for  use  as  a  location  finder.  The  (x,y)  coordinates  are  displayed  in 
the  Global  Menu  field. 

O  •  Display  Overlay  Map 

Gianges  the  background  vector  layer  to  use  as  reference.  This  option  is  available  only  if  the  user 
has  first  selected  a  vector  overlay  layer  using  the  Custonize/DLsplay  Menu. 

B  -  Display  Background  CELL  Map 

Gianges  the  background  raster  layer  to  use  as  reference.  This  option  is  available  only  if  the  user 
has  first  selected  a  background  raster  layer  using  the  Customize /Display  Menu. 

q  -  Return  from  whence  we  came 

Returns  the  user  to  the  previous  menu. 
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15.  THE  ZOOM  MENU 

This  option  provides  a  number  of  utilities  that  allow  the  user  to  move  through  the  vector  file  and  to 
zoom  or  pan  around  designated  features  within  it.  The  Zoom  Menu  can  be  accessed  from  all  the  other 
menus.  The  following  sequence  describes:  fust,  how  to  use  the  windowing  mode;  second,  the  Zoom 
mode;  and  third,  the  Pan  mode.  In  the  examples  below,  the  mouse  is  used  as  the  windowing  device 
(see  the  Customize  Menu). 

Upon  entering  Zoom  the  following  screen  appears: 


Buttons: 

left:  Select  new  window 

Middle:  Abort/Quit 
Right:  Zoom/Pan  MENU 


Selecting  the  LEFT  button  activates  the  mouse  for  use  as  a  WINDOWING  device. 


Buttons: 

left:  Establish  a  comer 
Midtile:  Widen  view 
Right:  Accept  window 


A  "rubber  band"  box  appears  in  the  current  working  window  w  ith  the  pointer  as  its  nexus.  To  examine 
an  area  within  the  current  working  window,  use  the  LEU'  button  to  choose  a  starting  comer,  and  drag 
the  pointer  to  an  opposite  comer  to  fonn  a  lx>x  around  the  designated  area  or  feature.  Choose  the 
RIGHT  button  to  accept  the  new  window.  Ihe  graphics  screen  refreshes,  and  tlx.'  new  area  is 
displayed.  If  tlx:  user  wishes  to  examine  an  area  outside  of  the  current  working  window .  then  use  the 
MIDDLE  button  to  widen  the  view .  When  this  option  is  chosen,  the  graphics  screen  is  refreshed,  and 
the  user  sees  a  recUuigular  blue  field  representing  the  Default  Region  created  for  the  current  data  layer. 
Ihe  last  working  window  examined  is  displayed  as  a  red  box  within  the  blue  field.  Surrounding  the 
blue  field  is  a  black  field  representing  the  area  (xitside  the  Default  Region.  Again,  use  the  left  button  to 
pul  a  lx>x  arcxuxl  the  desired  area  and  press  the  right  button  to  accept  it.  If  a  working  w  indow  totalis 
or  partially  outsi<k'  of  the  lie  fault  Region  is  selected,  the  following  warning  message  apjvars: 


[  Wind<  >w  is  outside  of  default.  Prix'eed?  [vj  ! 
After  choosing  the  new  w  indow  the  follow  ing  screen  again  appears: 


Buttons: 

l  eft:  Select  new  wiixtow 
Middle:  /Mxirt/CXiit 
Right:  Xnom/I’an  MENU 


IVessing  the  RIGHT  Ixitton  enters  the  Zixtm/Pan  mode. 


Buttons: 

left:  /mom  MENU 
Middle:  Alxrrt/Oiil 
Right:  Pan  MENU  j 


To  ZOOM  press  the  LEFT  button. 
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Buttans: 

Left:  Zoom  in 
Middle:  Abort/Quit 
Right:  Zoom  oat 


The  ZOOM  mode  can  be  used  to  move  as  far  away  from,  or  in  as  close  to,  a  feature  as  required.  Every 
time  a  button  is  depressed,  the  graphic  screen  is  redisplayed  with  the  newly  selected  area.  In  ZOOM, 
the  center  point  of  the  current  window  frame  is  used  as  the  reference  point  to  zoom  around.  This  point 
cannot  be  changed  in  the  ZOOM  mode.  It  can,  however,  be  changed  in  the  PAN  mode,  which  is  exam¬ 
ined  next.  To  exit  the  ZOOM  mode,  press  the  MIDDLE  button.  The  following  screen  again  appears: 


Buttons: 

Left:  Zoom  MENU 
Middle:  Abort/Quit 
Right:  Pan  MENU 


Press  the  RIGHT  button  to  enter  the  PAN  mode.  Movement  across  the  data  layer  is  determined  by  the 
position  of  the  mouse  pointer,  and  at  first  may  seem  counterintuitive.  The  next  screen  illustrates  the 
selection: 


Buttons: 

Left:  Specify  new  window 

Middle:  Abort/Quit 

Right:  Specify  new  window  CENTER 


The  LEFT  button  controls  movement  over  the  data  layer.  Placing  the  pointer  to  the  LEFT  side  of  the 
window  appears  to  move  features  to  the  RIGHT  and  vice  versa.  Likewise,  moving  the  pointer  to  the 
BOTTOM  of  the  window  appears  to  move  features  UP  in  the  window',  and  so  on.  The  frame  of  refer¬ 
ence  is  always  toward  the  CENTER  of  the  current  window.  Pressing  the  RIGHT  button  allows  the  user 
to  focus  on  a  specific  feature  and  make  it  the  center  of  reference. 

To  exit  out  of  the  Zoom/Pan  Menu,  continue  to  hit  the  MIDDLE  button  until  the  starting  menu  is 
accessed. 
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16.  THE  DEBUG  MENU 

The  Debug  Menu  was  originally  designed  for  locating  and  fixing  errors  in  v .digit  during  the  program’ s 
development.  It  is  available  in  an  incomplete  and  unsupported  form,  but  is  useful  for  finding  informa¬ 
tion  about  features  by  referenda  their  internal  topological  structure.  Within  the  Debug  Menu,  the 
word  line  is  used  genetically.  That  is,  all  features  originally  are  entered  as  vector  data  whether  sites 
(technically,  a  line  defined  by  one  point),  simple  lines,  or  lines  defining  area  perimeters.  It  can  be 
accessed  from  any  other  v.digit  menu  by  pressing  the  minus  or  dash,  key.  The  screen  layout  for 

the  Debug  Menu  is  presented  below: 


GRASS-DIGIT  Version  4.0  Debug  Menu 


Debug  options: 


I  - 

Di  spl ay 

1  i  ne 

info 

n  - 

Di  spl ay 

node 

i  nf  o 

a  - 

Di  spl ay 

area 

i  nfo 

L  - 

Fi  nd  1 i ne 

N  - 

Find  node 

A  - 

Find  art 

;a 

I  - 

Find  is! 

1  e 

d  - 

Di  spl ay 

Node  - 

lines 

q  - 

Quit  to 

mai  n 

menu 

Help 

Zo  am 

* 

* 

GUJUAI.  MENU: 

P  r  c  s  f 

;  first  letter  of  desired  conmand.  [Upper  Case  Only] 

16.1.  DEBUG  MENU  OPTIONS 

After  digitizing  or  importing  a  s  ector  file,  executing  the  programs  v.support  and  v.import  may  occa¬ 
sionally  give  a  wanting  message  alxxit  finding  duplicate  lalx'ls  for  a  given  line  or  area.  This  error  c;ut 
be  caused  by  two  things:  either  there  are  in  fact  duplicate  labels  in  the  file,  or  a  lalx-1  from  a  nearby 
;trea  or  line  has  been  wrongly  interpreted  as  Ix'longing  to  the  feature.  Ihe  first  error  is  only  prolv 
lematic  if  the  lalx-1  categories  for  the  feature  are  not  the  same.  In  this  case,  the  analyst  must  decide 
which  of  the  multiple  labels  is  correct  and  remove  the  other(s).  In  the  latter  case,  the  solution  may  lx- 
as  simple  as  moving  the  lalx-1  marker  position  using  the  label  Menu,  lliese  warning  messages  supph 
the  problem  feature's  internal  reference  numlx-r:  using  tliis  information  the  features  can  lx  investigates! 
using  IX'hug. 

IX'bug  is  divided  into  two  sets  of  either  mouse  inputs  or  kcylxwd  entries.  Type  in  the  first  letter  of  an 
option  name  to  activate  it.  Ihe  first  three  options.  "I,"  "n,"  aixl  "a."  use  the  mouse  to  |xiint  to  sjxcilic 
features.  Interactive  instmetions  will  ap]x-ar  on  the  dumb  terminal  screen  (or  the  shell  window  if  only  a 
graphics  monitor  is  used).  I,ike  the  Iulit  Menu,  most  debugging  operations  using  the  mouse  follow  a 
left -right  button  sequence  for  first,  choosing .  and  second,  accepting,  the  function.  The  middle  button  is 
used  to  quit  the  current  function.  All  the  options  ;ire  similar;  the  following  example  is  for  a  line:  "I  - 
Display  Eine  Info." 
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Choose  Line: 

Buttons: 

Left:  Choose  line 
Middle:  Abort/Quit 
Right:  Accept  chosen  line 


After  selecting  the  feature,  it  will  be  highlighted  (default  color  yellow)  on  the  graphics  screen.  Other 
information  will  appear  on  the  screen  where  the  global  menu  (bottom  menu)  had  been.  It  appears  in 
the  following  format  (again,  a  line  is  used  as  an  example). 


line#  8  Category:  2 

#8:  N1  8  N2  9  Left  0  Right  0 

Alt  13  (index  8)  Category  2  X  499230.058  Y  3439067,953 


The  arcane  descriptions  above  refer  to  the  internal  coordinates  defining  the  spatial  topology  of  the  line. 
For  example,  the  Line  #  is  8,  meaning  it  was  the  eighth  line  digitized  in  the  sequence.  It  has  been 
labeled  category  2.  It  is  linked  to  two  nodes,  #8  and  #9,  and  begins  at  #8.  It  is  the  13th  in  the  series 
of  labeled  features,  and  the  (x,y)  UTM  coordinates  of  node  8  are  provided.  The  Left  and  Right  fields 
refer  to  area  designations;  eg.,  if  the  lines  bounded  labeled  areas,  what  area  is  "left"  of  the  line  and 
what  area  is  "right"  of  the  line.  However,  since  this  line  is  not  an  area  edge,  the  fields  are  categorized 
as  "0" . 


The  KEYBOARD  commands  are  somewhat  more  flexible  and  provide  the  user  more  information,  for 
example:  "L  -  Find  Line."  Within  the  Global  Mem  field  the  following  information  will  appear: 


Enter  <CR>for  next  line,  #of  desired  line,  ’q’  quit: 
#  1:  N1  1N2  1  Left  0  Right  0 
Line  is  NOT  labeled 
Total  lines:  31 


The  user  can  proceed  through  the  sequence  of  features  by  pressing  the  <RETURN>key,  or,  if  known, 
the  number  of  the  feature  in  question.  In  the  example  above,  there  are  31  total  line  features  occurring 
within  the  vector  data  layer.  Options  "N"  and  "A"  function  similarly.  Other  functions  are  described  in 
the  following: 

I  -  Find  Isle 

Highlights  "island"  polygons,  or  areas  completely  surrounded  by,  or  embedded  within,  other  areas, 
and  describes  the  lines  defining  them. 

d  -  Display  Node-Lines 

Functions  similarly  to  the  "Display  Node  Lines”  option  within  the  Toolbox  Menu. 

q  -  Return  from  whence  we  came 

Returns  to  the  previous  menu. 

After  locating  the  problem  features,  the  user  has  several  options  to  modify  them.  One  way  is  to  use 
other  v.digit  menus,  such  as  Edit  or  label  and  remove  or  change  the  suspect  feature.  Another  more 
involved  procedure  is  to  change  the  binary  vector  file  into  ASCII  (American  .Standard  Code  for  Infor¬ 
mation  Interchange)  format  using  the  v .out .ascii  program.  This  creates  a  text  file  within  the  dig_ascii 
directory  within  the  current  mapset.  The  file  can  then  be  edited  using  vi  and  then  converted  back  to  a 
binary  file  using  the  vjn.ascii  program.  Other  programs  like  v .support  or  v.clean  can  also  lx:  used. 
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17.  EXITING  v  .digit 

To  exit  the  v.digit  program,  return  to  the  Main  Menu  and  type  Q  to  "Quit."  The  following  message 
appeals: 


Leave  digit?  [n] 


To  leavj,  type  y  and  <RETURN> after  the  query.  If  any  modifications  to  the  vector  file  have  been  per¬ 
formed,  the  following  sequence  appears  in  rapid  succession: 


Compressing  Data:  DONE 

Compressing  NODES.  LINES.  AREAS.  ISLES.  ATTS.  Writing  Plus  File  .  .  .  DONE 
Do  you  want  to  compress  the  Alts  file  [n] _ 


This  query  refers  to  the  vector  file  in  the  dig_atl  directory  in  the  user’s  GRASS  mapset.  In  most  cases, 
the  user  wants  to  answer  with  the  default,  [n].  This  way,  all  information  about  the  file,  both  old  and 
new',  is  retained,  although  it  is  only  the  newer  that  is  accessed  in  future  sessions.  Until  you  are  certain 
that  the  file  is  entirely  completed,  answer  n. 

If  the  user  answers  y,  the  program  deletes  the  attributes  from  the  file  that  are  not  represented  in  the 
current  version  of  the  vector  file.  Examples  of  such  items  include  the  old  labels  for  relabeled  features, 
changes  in  topology,  etc.  The  effect  is  to  "clean"  the  attribute  file  for  the  vector  layer  created  or 
modified  during  the  just  completed  digitizing  session.  In  this  way  the  attribute  file  is  brought  in  line 
with  the  most  current  version  of  the  map.  In  addition,  if  error  messages  about  duplicate  attributes  are 
encountered  when  ninning  v.support,  they  can  sometimes  be  eliminated  by  answering  positively  to  the 
above  prompt.  Upon  exiting  v.digit,  you  will  be  returned  to  the  GRASS  prompt. 
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